Update and improve metaschema documentation of models and syntax #657
Labels
enhancement
model-refactor
Used to mark issues related to model refactoring for the Metaschema v4 transition.
Scope: Modeling
Issues targeted at development of OSCAL formats
User Story
Milestone
User Story:
Documentation of OSCAL models and syntax in the metaschemas is due for maintenance.
This includes formal names, descriptions and remarks on assemblies, fields, flags and their constraints. It does not include embedded or linked samples, which will require a bit more development to support in the new Metaschema (see usnistgov/metaschema-xslt#14).
See usnistgov/metaschema#363, which encompasses this work item along with work on the web site.
Goals:
Documentation of models, syntax, constraints and semantics of the OSCAL models -- especially at the Implementation layer, but also throughout -- needs to be up to date.
To this end, for this Issue, we should revise, update and improve documentation embedded in the metaschemas.
Dependencies:
Since it happens in the metaschema files, this work needs to be coordinated with parallel work on the models.
Acceptance Criteria
The text was updated successfully, but these errors were encountered: