Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.
Sign upSome Notes should be presented as a part of specification #176
Comments
This comment has been minimized.
Show comment
Hide comment
This comment has been minimized.
bterlson
Dec 8, 2015
Member
Many contents of the NOTE for the Language seems to be specifications expressed in English rather than just an informative note.
@ToshiKurokawa In general, notes will frequently restate what the specification text says for a specific case especially when that case has a history of being misinterpreted. I believe the rationale here is for these to be notes so we don't create any doubt about what the normative requirements actually are, and to avoid bugs cropping up in implementations due to a conflict in normative semantics that are potentially spread out around the spec.
Changing this convention at this point would require stronger motivation than what is presently given. I'm closing this for now, but please re-open if you would like to discuss further (and I will try not to miss this issue for so long next time :))
@ToshiKurokawa In general, notes will frequently restate what the specification text says for a specific case especially when that case has a history of being misinterpreted. I believe the rationale here is for these to be notes so we don't create any doubt about what the normative requirements actually are, and to avoid bugs cropping up in implementations due to a conflict in normative semantics that are potentially spread out around the spec. Changing this convention at this point would require stronger motivation than what is presently given. I'm closing this for now, but please re-open if you would like to discuss further (and I will try not to miss this issue for so long next time :)) |
ToshiKurokawa commentedNov 15, 2015
[JP22] This is not a factual issue but a meta issue for the style of standard document:
Many contents of the NOTE for the Language seems to be specifications expressed in English rather than just an informative note. I’ve got that from notes in 13.3.2.4, 13.7.5.9, 13.10, 13.11. It looks that a subclause entitled “Summary” might be useful to guide the readers of this document.