diff --git a/style-guide.md b/style-guide.md index 5820af5091..8d4bf7139d 100644 --- a/style-guide.md +++ b/style-guide.md @@ -21,6 +21,7 @@ The following additional rules should be followed but currently are not enforced 9. Use [Oxford commas](https://en.wikipedia.org/wiki/Serial_comma), avoid [Shatner commas](https://www.latimes.com/archives/blogs/jacket-copy/story/2011-06-30/goodbye-oxford-comma-hello-shatner-comma). 10. Use `` for link anchors. The `` format has been deprecated. 11. Headings use [title case](https://en.wikipedia.org/wiki/Title_case) and are followed by a blank line. +12. Do not use [RFC2119 key words (MUST, MAY, ...)](https://datatracker.ietf.org/doc/html/rfc2119) in "Examples" sections or when explaining examples, and state requirements only in sections that are clearly normative. Plus some suggestions, rather than rules: