[i18n-activity] clarify permitted language tags for titles/descriptions (#684)

aphillips has just created a new issue for https://github.com/w3c/i18n-activity:

== clarify permitted language tags for titles/descriptions ==
6.2.10 titles and descriptions
https://cdn.staticaly.com/gh/w3c/wot-thing-description/TD-TAG-review/index.html?env=dev#titles-descriptions-serialization-json

> Whenever the vocabulary terms titles and descriptions can be used, both MUST be serialized as JSON Object. The member names of the JSON Object MUST be the language tags as defined in [BCP47] (e.g., "en", "de", "ja", "zh-Hans", "zh-Hant"). 

The above text would be clearer with some adjustments:

* I would change "...can be used, both MUST..." to "...are used, each MUST...", on the assumption that these can appear independently from one another.

* The sentence attempting to require BCP47 language tags might be better and more clear about what is expected if written more like:

> The member names of the JSON Object MUST be valid [BCP47] language tags.

... I would note that BCP47 defines how language tags are formed and how the subtag registry is operated, but doesn't (strictly speaking) define each language tag directly. The other thing is that I dragged in the term "valid", although you might only wish to impose a normative requirement of "well-formed" (see BCP47 for details on the difference).

---
**WHEN CREATING A NEW ISSUE DO SO ABOVE THIS PARAGRAPH, REPLACING THE PROMPTS, BUT LEAVE THIS PARAGRAPH INTACT AS WELL AS THE TEXT BELOW IT** When this issue is raised in the github/bugzilla/mail of the WG that owns the spec, use the text above this para as the basis for that comment. Then edit this issue to remove this paragraph and ALL THE TEXT ABOVE IT. Replace the text 'link_to_issue_raised' below with a link to the place you raised the issue, but leave the remaining text below this para unaltered.

**This is a tracker issue.** Only discuss things here if they are i18n WG internal meta-discussions about the issue. **Contribute to the actual discussion at the following link:**


ยง link_to_issue_raised



Please view or discuss this issue at https://github.com/w3c/i18n-activity/issues/684 using your GitHub account

Received on Thursday, 18 April 2019 20:14:39 UTC