Add notes regarding label usage, provided by i18n review#841
Add notes regarding label usage, provided by i18n review#841anssiko merged 6 commits intowebmachinelearning:mainfrom inexorabletash:i18n-label-notes
Conversation
A suggested by @xfq, add additional details about operator labels, clarifying that they are not intended to be natural language strings. And include an advisement that use of developer-provided labels is subject to spoofing, and implementations should sanitize them.
|
@xfq can you take a peek at the additions? I quoted your excellent suggested text directly. |
anssiko
left a comment
There was a problem hiding this comment.
The text in itself looks great to me. A suggestion on where to place this text:
Folks reading the Programming Model section may feel this section is too label heavy, so I suggest we place this text in https://www.w3.org/TR/webnn/#dom-mloperatoroptions-label instead.
Similarly, I'd propose to migrate the existing label related note to the same section.
(Per https://www.w3.org/TR/international-specs/#I18N_Considerations another option would be a dedicated Internationalization Considerations section but it seems inline in the body of the specification is preferred.)
Done in a3f8ab2 |
Co-authored-by: Anssi Kostiainen <[email protected]>
SHA: 9527a73 Reason: push, by anssiko Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
A suggested by @xfq, add additional details about operator labels, clarifying that they are not intended to be natural language strings. And include an advisement that use of developer-provided labels is subject to spoofing, and implementations should sanitize them.
Resolves #837
Preview | Diff