1.1 Terminology notes

In this document, unless otherwise clarified:

  • The term comment always refers to implementation comments. We do not usethe phrase documentation comments, instead using the common term “JSDoc”for both human-readable text and machine-readable annotations within/* … /.

  • This Style Guide uses RFC 2119 terminology when using the phrases must,must not, should, should not, and may. The terms prefer andavoid correspond to should and should not, respectively. Imperativeand declarative statements are prescriptive and correspond to must.

Other terminology notes will appear occasionally throughout the document.