Notes are always informative

plehegar commented 6 years ago

If you use something like <p class="note">Note:

in your document, it is inappropriate to use normative text within those.

svgeesus commented 6 years ago

I think this might best be addressed in the manual of style as follows:

rename section 10. RFC 2119 Key Words to 10. Normative and Informative
make 10.1 which says to clearly indicate non-normative sections, that figures, examples and notes are non-normative
place the current info about RFC 2119 in 10.2 RFC 2119 Key Words.
make 10.3 Consistent Expectations. Add text saying that normative notes break user expectations and will be misread as informative even if they were marked normative. Add a sentence saying that RFC 2119 keywords must not be used in informative sections.

If that plan looks good, I'm happy to draft text and send a pull request.

plehegar commented 6 years ago

The plan looks good to me. Thank you for willing to put a PR forward.

svgeesus commented 6 years ago

svgeesus commented 6 years ago

See https://w3c.github.io/manual-of-style/#consistent-expectations (unfortunately, ReSpec does not style link targets specially, but the text is at least directly linkable)

w3c / manual-of-style