Home

Automated Documentation

The scope of the ISO/TC 211 ad hoc group on Automated documentation is to develop a structure for machine-readable normative statements and study model-driven documentation of standards.

Meetings

• Meeting #2, 2020 12 16
• Meeting #3, 2021 01 13
• Meeting #4, 2021 2 23
• Meeting #5, 2021 03 16
• Meeting #6, 2021 04 23
• Meeting #7, 2021 05 20
• Meeting #8, 2021 09 30

Normative statements

Normative statements, conformance classes and test are often written in pure text, not as executable code. Questions have been raised whether they should be machine-readable and possibly also machine-testable. however, not all statements can be machine-testable. Machine-readable statements would require a structured model for statements. OGC has defined a Requirements model for their standards. This ad hoc group shall develop a draft «statements» model. The model shall be linked to the ISO 19105 model and serve as input for future standardization.

Model-driven documentation

An ad hoc group (ref ISO/TC 211 resolution 633) studied model-driven documentation of ISO/TC 211 standards in 2013. Templates for Enterprise Architect and ShapeChange were developed and are available on https://github.com/ISO-TC211/UML-Best-Practices/wiki/DocumentationOfUmlModels. The template has not been much used, probably only by ISO 19135-1. However, the ISO 19170-1 document was generated from EA using: EA => ShapeChange => Metanorma => ISO document. This ad hoc group will study approaches for MDD and how we facilitate for use in ISO/TC 211 standardization projects.

Notes from the discussions:

https://github.com/ISO-TC211/AutomatedDocumentation/wiki/MDD-Sources-and-processes