Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Preserve language and direction for declarative tool descriptions

Aperta
  • Qualcosa non va?
#276 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
38/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
html
Ambito
internationalization

Direzione di ricerca

Read declarative-api-explainer.md around the tooldescription and toolparamdescription definitions, then inspect index.bs around the schema-synthesis TODO and the related issues #153, #210, and #273. Decide how authors express language and direction, preserve that metadata in synthesized descriptions, and specify how localized alternatives are handled or deferred.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

declarative i18n-tracker

Summary

The declarative API explainer places natural-language tool metadata in the
tooldescription and toolparamdescription HTML attributes, then turns those values into a tool
description and JSON Schema property descriptions. The current proposal does not define how the
language or base direction of those strings is determined or preserved during that conversion.

This is the declarative-markup part of #153, identified while reviewing the checklist in #273.

Current text

Internationalization concern

W3C's Internationalization Best Practices for Spec Developers says that:

The current explainer does not say:

  1. whether these new attributes are translatable;
  2. whether their values use the form control's inherited HTML lang and dir/auto context; or
  3. how that context is carried into the synthesized tool definition and JSON Schema instead of
    being reduced to an unlabelled string.

This matters even when a description is primarily agent-facing: property descriptions and other
schema annotations may be surfaced in confirmation or native UI, and the tool title is explicitly
defined for user interfaces.

Resolution criteria

Before defining the declarative synthesis algorithm in #210, decide whether to:

  • represent descriptions as element content (allowing ordinary HTML lang, dir, and inline
    markup), or
  • keep attributes but normatively define their translation, language, and direction behavior and
    preserve that metadata in the synthesized representation.

The solution should also state how authors provide localized alternatives, or explicitly defer that
part to the resolution of #153.

Maintainers: please apply the i18n-tracker label so the Internationalization WG is notified, as
requested by #273. I cannot apply repository labels with my current permissions.

Lingua principale
Bikeshed
Stelle
4.7k
Fork
328
Merge medio
2g 15h
PR unite (30g)
16

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di webmachinelearning/webmcp

Tutte le issue di webmachinelearning/webmcp

Issue simili

Altre issue su Internationalization

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.