- In AsciiDoc documentation, prefer
JSON{plus}{plus}andjq{plus}{plus}over literalJSON++andjq++. - This also applies inside backticks and other inline markup in
.adocfiles, where literal++may render incorrectly or disappear in generated HTML. - For filename extensions and concrete command/file examples where the literal text matters, keep the real spelling such as
.json++orjq++if that is what users must type.
- Define a term at its first use, or link to its definition in
tools/etc/docs/concepts/terminology.adoc. This applies to issue comments and design proposals, not only shipped documentation. - Use one name per concept. Do not alternate synonyms (for example "token" / "marker" / "positional token") for the same thing.
- New concepts introduced by a design belong in
terminology.adocwhen the design lands.