# Conventions for Specifications and TRMs (Conventions)

> How the documents of this anthology are written and read — normative language, required structure, citation and addressing, and the style rules for specifications and for technical reference manuals.

The whole book as one markdown file: [/peios/advanced-peios/conventions/print.md](/peios/advanced-peios/conventions/print.md)

Contents:

- 1 [Introduction](/peios/advanced-peios/conventions/introduction/scope.md)
    - 1.1 [Scope](/peios/advanced-peios/conventions/introduction/scope.md)
    - 1.2 [The Two Document Classes](/peios/advanced-peios/conventions/introduction/the-two-document-classes.md)
    - 1.3 [How to Read This Book](/peios/advanced-peios/conventions/introduction/how-to-read-this-book.md)
- 2 [Normative Language](/peios/advanced-peios/conventions/normative-language/rfc-2119-keywords.md)
    - 2.1 [RFC 2119 Keywords](/peios/advanced-peios/conventions/normative-language/rfc-2119-keywords.md)
    - 2.2 [Informative Text](/peios/advanced-peios/conventions/normative-language/informative-text.md)
    - 2.3 [Pseudocode](/peios/advanced-peios/conventions/normative-language/pseudocode.md)
- 3 [Specification Structure](/peios/advanced-peios/conventions/specification-structure/required-articles.md)
    - 3.1 [Required Articles](/peios/advanced-peios/conventions/specification-structure/required-articles.md)
    - 3.2 [Roles](/peios/advanced-peios/conventions/specification-structure/roles.md)
    - 3.3 [Data Conventions](/peios/advanced-peios/conventions/specification-structure/data-conventions.md)
    - 3.4 [Extension and Conformance](/peios/advanced-peios/conventions/specification-structure/extension-and-conformance.md)
- 4 [Technical Reference Manuals](/peios/advanced-peios/conventions/technical-reference-manuals/what-a-trm-is.md)
    - 4.1 [What a TRM Is](/peios/advanced-peios/conventions/technical-reference-manuals/what-a-trm-is.md)
    - 4.2 [Voice](/peios/advanced-peios/conventions/technical-reference-manuals/voice.md)
    - 4.3 [Structure](/peios/advanced-peios/conventions/technical-reference-manuals/structure.md)
    - 4.4 [Describing the True State](/peios/advanced-peios/conventions/technical-reference-manuals/describing-the-true-state.md)
    - 4.5 [Proposals](/peios/advanced-peios/conventions/technical-reference-manuals/proposals.md)
    - 4.6 [Citing a Specification](/peios/advanced-peios/conventions/technical-reference-manuals/citing-a-specification.md)
    - 4.7 [Citing a Manual](/peios/advanced-peios/conventions/technical-reference-manuals/citing-a-manual.md)
- 5 [Citation and Addressing](/peios/advanced-peios/conventions/citation-and-addressing/section-addressing.md)
    - 5.1 [Section Addressing](/peios/advanced-peios/conventions/citation-and-addressing/section-addressing.md)
    - 5.2 [Citing Between Books](/peios/advanced-peios/conventions/citation-and-addressing/citing-between-books.md)
    - 5.3 [Granularity](/peios/advanced-peios/conventions/citation-and-addressing/granularity.md)
    - 5.4 [Validation](/peios/advanced-peios/conventions/citation-and-addressing/validation.md)
- 6 [Shared Style](/peios/advanced-peios/conventions/shared-style/appendices.md)
    - 6.1 [Appendices](/peios/advanced-peios/conventions/shared-style/appendices.md)
    - 6.2 [Tables and Enumerations](/peios/advanced-peios/conventions/shared-style/tables-and-enumerations.md)
    - 6.3 [Notes](/peios/advanced-peios/conventions/shared-style/notes.md)
    - 6.4 [Formatting](/peios/advanced-peios/conventions/shared-style/formatting.md)
    - 6.5 [Naming External Constants](/peios/advanced-peios/conventions/shared-style/naming-external-constants.md)
- Appendix A [Normative References](/peios/advanced-peios/conventions/normative-references.md)