In managing RDF resources, it is essential to balance the stability of URIs with the stability of their referenced content:
URI Stability: URIs must remain constant over time. This ensures that each URI consistently references the same resource, providing a reliable point of reference in web-based knowledge systems.
Content Stability: The content accessed via these URIs should be stable and avoid introducing breaking changes. This stability is crucial for 3rd party systems referencing these URIs, ensuring that their interactions remain consistent.
Idea
The solution proposed is to rely on Semantic Versioning in the form of MAJOR.MINOR.PATCH - to append the MAJOR version number to the URI.
For instance:
https://w3id.org/okp4/ontology/<MAJOR>/<path>
By including only the MAJOR version number in the URI, significant updates that could impact compatibility gives a new ontology version being referenced with a different namespaces. MINOR updates and PATCH (which do not result in breaking changes) have no impact on the URI, maintaining the stability of the URI for external references.
Todo
[x] Append MAJOR version placeholder to URIs
[x] Review all existing URIs within the OKP4 ontology
[x] Append a placeholder indicating the MAJOR version to each URI. For instance: https://w3id.org/okp4/ontology/<path>/v<MAJOR>
[x] Modify Ontology Build Process
[x] Update the ontology build process to substitute the <MAJOR> placeholder in each URI with the current major version number of the ontology
[x] Check it's compatible with the release process
Context
In managing RDF resources, it is essential to balance the stability of URIs with the stability of their referenced content:
Idea
The solution proposed is to rely on Semantic Versioning in the form of
MAJOR.MINOR.PATCH
- to append theMAJOR
version number to the URI.For instance:
By including only the
MAJOR
version number in the URI, significant updates that could impact compatibility gives a new ontology version being referenced with a different namespaces.MINOR
updates andPATCH
(which do not result in breaking changes) have no impact on the URI, maintaining the stability of the URI for external references.Todo
MAJOR
version placeholder to URIsMAJOR
version to each URI. For instance:https://w3id.org/okp4/ontology/<path>/v<MAJOR>
<MAJOR>
placeholder in each URI with the current major version number of the ontology