Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Preserve language and direction for declarative tool descriptions

Đang mở
  • Có gì không ổn?
#276 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
38/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
html
Lĩnh vực
internationalization

Hướng nghiên cứu

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.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.

Ngôn ngữ chính
Bikeshed
Star
4.7k
Fork
328
Merge trung bình
1 ngày 21 giờ
Pull request đã merge (30 ngày)
15

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của webmachinelearning/webmcp

Tất cả issue của webmachinelearning/webmcp

Issue tương tự

Thêm issue về Internationalization

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.