Author CSA documents with Metanorma

Document attributes

Note

The document attributes listed below are unique to Metanorma’s processing of CSA documents.

For common document attributes, see Document attributes reference in general Metanorma author’s documentation. That page describes attributes that apply to all Metanorma flavors, not just CSA

For an introduction to Metanorma AsciiDoc document attributes and how Metanorma uses them, see the corresponding topic.

:doctype:

Mandatory. The document type (see CSA deliverables: The different types of CSA publications). Permitted types: guidance, proposal, standard, report, whitepaper, charter, policy, glossary, case-study.

:status:

Document status. Permitted types: proposal, working-draft, committee-draft, draft-standard, final-draft, published, withdrawn. Synonym: :docstage:.

:committee:

Mandatory. Name of relevant CSA technical committee

:role_{i}

The role of a person contributing to the document. Permitted types: lead author (default), contributor, staff (i.e. CSA Global Staff), reviewer

Metanorma AsciiDoc markup

  • The [keyword]#...# markup encodes keywords, such as "MUST" and "MUST NOT". (The result is formatted as <span class="keyword">…​</span>.)