...
must not: This phrase, or the phrase "SHALL NOT", mean shall not, means that the definition is an absolute prohibition of the specification.
...
<<Link to security-related APIs here>>
Replace "&" with "and", except for acronyms such as A&AI, OA&M
<<TBD: fonts/indications of code, user input, system output>>
...
Foreign phrases and abbreviations (avoid, and what to substitute)
-e.g. > for example, -> "for example", "such as"
- i.e. -> that "that is" (or rephrase)
- via ( → "through", or sometimes "by) "
if you DO use "e.g." and "i.e.", use commas after thesequote marks - avoid <<can we drop this? We're using quote marks on this page, and we need to.>>
Try to keep sentences 25* words or less. If very lengthy, consider rephrasing and breaking into a bulleted list.
* Sometimes impossible but worth shooting for.
...