| ... | ... | @@ -137,7 +137,7 @@ Our version numbers are in the form of _X.Y.Z_ . _X_ indicates _major version_ - |
|
|
|
A list of all changes compared to previous version is given in our [glossary specification page](https://owl.emglossary.helmholtz-metadaten.de).
|
|
|
|
|
|
|
|
### Change management
|
|
|
|
With emg.owl we intend to provide stable semantics. This is ensured by classes going through a community definition and review process before being added to the artifact and released. IRIs in the artifact will stay stable according to semantic meaning of that class. I.e. minor changes or adjustments of definition, comment and annotation properties may be implemented without issuing a new IRI. Should the meaning of a previously existing class however change substantially, we will mark this class as obolete under the exiting IRI and introduce a new class under a new IRI. This is supposed to prevent unnoticed semantic drift during adoption. All changes to classes will be documented in the release descriptions.
|
|
|
|
With emg.owl we intend to provide stable semantics. This is ensured by classes going through a community definition and review process before being added to the artifact and released. IRIs in the artifact will stay stable according to semantic meaning of that class - minor changes or adjustments of definition, comment and annotation properties may be implemented without issuing a new IRI. Should the meaning of a previously existing class change substantially, we will mark this class as obsolete under the exiting IRI and introduce a new class under a new IRI. This is supposed to prevent unnoticed semantic drift during adoption. All changes to classes will be documented in the release descriptions.
|
|
|
|
|
|
|
|
### OWL build pipeline
|
|
|
|
The classes, class hierarchy and annotation properties are all sourced from the [yaml files](https://codebase.helmholtz.cloud/em_glossary/em_glossary/-/tree/main/terms) that are the output of our community process. Every merge to main in our [community repository](https://codebase.helmholtz.cloud/em_glossary/em_glossary) triggers a CI/CD pipeline that automatically assembles [emg-edit.owl](https://codebase.helmholtz.cloud/em_glossary/em_glossary_owl/-/blob/main/development/emg-edit.owl). Keys for annotation properties are sourced from external well-established vocabularies which are set up in [empty.owl](https://codebase.helmholtz.cloud/em_glossary/em_glossary_owl/-/blob/main/development/empty.owl). The empty.owl is the input for the parsing routine in [yaml_to_owl.py](https://codebase.helmholtz.cloud/em_glossary/em_glossary_owl/-/blob/main/development/yaml_to_owl.py).
|
| ... | ... | |
| ... | ... | |