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
• Meeting #9, 2021 10 28
• Meeting #10, 2021 11 26

Normative statements

Normative statements, conformance classes and test are often written in pure text, not as executable code. Questions have been raised regarding 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 used much, 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