Authoring guide for OGC documents

Scope

This document provides details for an OGC author on how to create OGC deliverables using Metanorma.

Note	Please use the latest version of Metanorma with this guide. Some guidance may not be compatible with older versions. Details on how to install the latest version of Metanorma.

Normative references

• Metanorma AsciiDoc

• OGC Specification Model — ModSpec (08-131r3)

Contents

This guide assumes familiarity with the normative references listed above.

The following sections provide a step-by-step guide allowing you to create an OGC deliverable compliant with OGC requirements and guidance.

Consider going through them step by step.

1. Terms used in this guide

2. Introduction to Metanorma AsciiDoc

3. Creating a new document

4. Encoding document metadata

5. Sections required

6. Block text syntax

7. Text formatting syntax

8. Entering cross-references

9. Adding terms and definitions

10. Adding bibliographic entries

11. Adding ModSpec requirements