-
Notifications
You must be signed in to change notification settings - Fork 3
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Validation of OGC requirements as standalone YAML #242
Comments
Discussed with OGC staff on 2023-11-06. Agreement to leave this Issue open until a resource becomes available to work on it. The resource would be a ruby developer that understands the ModSpec. |
Discussed 2024-02-15 Ribose will provide a prototype for showing to the OAB. |
@opoudjis to look into whether there is a schema validation tool/language for YAML (e.g. similar to JSON Schema or XSD). |
Done in #493 (comment) . There are lots of ad hoc schemas specific to implementations, and done as YAML objects themselves. But the standard way of doing it is JSON Schema, since JSON and YAML are both just serialisations of objects; and there is a well-used Ruby implementation of JSON Schema. JSON Schema is kind of clumsy, but I would recommend its use as a recognised standard. |
Validation implementation: |
This is done in: |
Review and confirm |
metanorma/ogcapi-processes#2 has resulted in the addition of OGC requirements, properly specified, to metanorma-ogc, as documented in https://www.metanorma.org/author/ogc/topics/requirements/
The Modular Specification, https://www.ogc.org/standards/modularspec, has a grammar of OGC requirements, setting out the cardinalities and attributes of different types of requirement; see Appendix C of that document, which is also represented in https://github.com/opengeospatial/NamingAuthority/blob/master/definitions/models/modspec.ttl and in metanorma/metanorma-requirements-models#11 (which resulted in a LutaML encoding of the UML in ModSpec Appendix C).
It is desirable to validate requirements entered for OGC against this model. This validation could be done within metanorma, but it makes more sense to validate OGC requirements as standalone YAML files, to be included into OGC Metanorma documents via a lutaml plugin.
So
would be sourced as a standalone YAML file looking like:
And the file would be validated by lutaml for conformance to the UML grammar according to its type.
The text was updated successfully, but these errors were encountered: