These docs are under active development and cover the v0.20 Kobicha security model.
On this page
§5.2

Informative Text

§5.2.1 Default

All text in a PSD is normative unless explicitly marked otherwise.

§5.2.2 Informative markers

Text MUST be marked as informative using one of the following:

  • Block quotes with the [!INFORMATIVE] callout:

    > [!INFORMATIVE]
    > This text provides context but does not define behavior.
    
  • Inline introduction using "For example" or "Note:":

    For example, a token with no groups would have an empty group list.
    
    Note: this behavior differs from the Windows implementation.
    

Informative text MUST NOT contain normative keywords (MUST, SHALL, etc.) used in their RFC 2119 sense. If an informative block needs to describe required behavior, it SHOULD refer to the normative clause that defines it.

§5.2.3 Clause numbering

Informative text MUST NOT receive clause numbers. Only normative statements are numbered (see §6.1).