Namespaces and identifiers
Give a term a stable semantic home, distinguish it from the things it describes, and keep identifiers independent of labels, files and releases.
Technical modelling guide Method reference
Method basisUpdated
A namespace does two useful jobs: it keeps names distinguishable and makes their governance boundary explicit. It does not define a concept, establish an entity’s identity or approve a model. OPDA’s selected scheme uses https://opda.org.uk/ns/ for vocabulary and https://opda.org.uk/id/ for individual resources, with separate rules for each.
First distinguish three states
ODR-0065 selects the namespace policy explained here; implementation in ontology artefacts remains pending. Selecting that policy does not rename the existing ontology, regenerate the Property Pack candidate or make these example addresses live. Read an identifier together with its corpus and decision status.
| State | IRI base | What it establishes |
|---|---|---|
| Existing schema-derived corpus | https://opda.org.uk/pdtf/ | The existing corpus retains its identifiers and historical decisions. It remains source evidence, not the seed of the new domain model. |
| Versioned Property Pack candidate | https://w3id.org/opda/candidate/property-pack/0.1/ | The machine-proposed candidate retains its present IRIs. Its versioned base identifies that candidate space, not approved permanent domain vocabulary. |
| Selected namespace policy | https://opda.org.uk/ns/https://opda.org.uk/id/ | The naming and admission rules for future governed use. Selection is not a migration, publication or dereferencing receipt. |
A term called Report in all three spaces is not thereby one term. Replacing a base string would mint a different IRI without establishing correspondence, preserving an identity criterion or approving the new definition. Any eventual transition needs its own scoped decisions and evidence.
Choose the family by meaning and authority
The selected topology adapts semantic-modelling’s scheme to opda.org.uk. Its root kernel and common boundary are deliberately different. The kernel describes how the ontology is classified or governed; common contains domain meaning genuinely shared across contexts.
| Family | Appropriate content | Do not infer |
|---|---|---|
/ns/ | Cross-cutting metamodel terms: justified annotation properties, classification schemes and shared quality-gate infrastructure. | That every important property-domain concept belongs in the root. |
/ns/common/ | The deliberately small shared domain boundary: reviewed common concepts, vocabularies and mappings. | That use by a second consumer automatically transfers definition authority. |
/ns/{bc}/ | Terms governed by one established context, using its registered token. | A hierarchy of contexts, source applications or organisational departments. |
/ns/meta/ | Independently justified metaclasses and their shapes, when that modelling need is admitted. | Adoption of the upstream project’s entire governance infrastructure. |
| Facet subnamespaces | Values of specifically selected classification facets, separated from domain ownership. | A new bounded context for every subject, lifecycle stage or sensitivity label. |
/id/{type}/{ref} | Individual entities identified under a governed type and reference convention. | That an individual is an ontology term or that its path proves its identity. |
There is no additional /core/ layer: the cross-cutting kernel is /ns/ itself. Nor does a directory called schema determine a semantic namespace. For a root-level term, justify all three commitments: cross-cutting scope, metamodel meaning and no property-domain meaning. A reusable domain class belongs in its justified context or common boundary, not in the kernel because it seems foundational.
Upstream facet families include subject, dataclass, lifecycle, gov, vol, reg and valuechain. Their names are reserved against context-token collisions; reservation does not introduce seven new OPDA modelling obligations. Only selected facets and justified values are admitted. Subject classification answers “what is this about?”; context ownership answers “who governs this meaning?”
Use the established contexts, with stable tokens
The tokens reuse abbreviations already recorded in the Property Pack candidate manifest. Their selected bases are new policy; the candidate’s existing full IRIs remain unchanged. These are flat peers, not nested branches of a larger business-domain tree.
| Boundary | Preferred alias | Selected base |
|---|---|---|
| Finance and Banking | fb: | https://opda.org.uk/ns/fb/ |
| Conveyancing | conv: | https://opda.org.uk/ns/conv/ |
| Estate Agency | ea: | https://opda.org.uk/ns/ea/ |
| Surveying and Valuation | sv: | https://opda.org.uk/ns/sv/ |
| Property Data Services | pds: | https://opda.org.uk/ns/pds/ |
| Property Technology | pt: | https://opda.org.uk/ns/pt/ |
| Common boundary | common: | https://opda.org.uk/ns/common/ |
| DBT Smart Data scheme | dbt: | https://opda.org.uk/ns/dbt/ |
The first six rows are the established OPDA bounded contexts. Common is a separately governed shared boundary; DBT Smart Data is scheme scope, not a seventh OPDA bounded context. Namespace allocation does not create relationships between these boundaries or settle which candidate terms each should own.
Treat sv as a stable token after adoption, not a phrase to regenerate from a display label. Renaming a working group, translating its label or changing a prefix alias does not rename /ns/sv/. Likewise, do not insert a source-system name beneath it merely because two applications use different vocabulary within the same governed context.
A type, a controlled value and an individual need different names
Consider a fictional inspection and report. The following IRIs illustrate the selected rules; they do not declare these terms, settle their definitions or approve Surveying and Valuation as their semantic home.
| What is named | Illustrative IRI |
|---|---|
| An Inspection class | https://opda.org.uk/ns/sv/Inspection |
| A reportsInspection property | https://opda.org.uk/ns/sv/reportsInspection |
| A ReportStatus class and its concept scheme | https://opda.org.uk/ns/sv/ReportStatushttps://opda.org.uk/ns/sv/ReportStatusScheme |
| The scheme’s controlled draft value | https://opda.org.uk/ns/sv/ReportStatus/draft |
| One particular inspection | https://opda.org.uk/id/inspection/INS-0042 |
Classes and facet concepts use UpperCamelCase; properties use lowerCamelCase. Class-oriented shapes use a Shape suffix: an illustrative sv:InspectionShape would be distinct from the Inspection class. A closed, ontology-owned enumeration uses a per-value-class subnamespace with lowercase value names. The scheme resource and the value subnamespace are distinct: ReportStatusScheme identifies the scheme; ReportStatus/draft identifies one concept in it. Shared values follow the same pattern under /ns/common/ only after justified common-boundary admission.
The last row identifies a particular inspection, not the class of inspections. Its type is lowercase and hyphenated when necessary, such as report-version. Its ref follows the key convention approved for that type, preserving meaningful case. Prefer an authoritative external code, stable business key or managed registry reference over a changing label. Do not add the originating application to the IRI to record provenance.
A finite file is not necessarily a closed vocabulary. A snapshot of externally maintained reference data remains instance data when its population is open-ended. Conversely, an ontology-owned status concept remains vocabulary even though it is an RDF individual used as a value. The governing definition and maintenance responsibility decide the family, not the number of rows.
The business key helps identify and join records; it is not the identity criterion itself. Two systems can reuse INS-0042 for different events, or give different keys to the same event. Establish the identifier’s authority, population and collision rules before minting. Never infer sameness from matching suffixes alone. Do not expose personal or confidential identifiers for readability; select a safe managed reference where necessary. If a suitable governed external IRI already identifies the intended entity, reuse it rather than creating an OPDA copy just to fit this pattern.
Prefixes abbreviate; governance explains
With sv: explicitly bound to https://opda.org.uk/ns/sv/, sv:Inspection abbreviates the first example. Another document could bind survey: to that same base and name the same term. Conversely, the candidate can use sv: with a different base and name a different term. The expanded IRI matters, not the letters before the colon.
This is especially important for opda:. In this policy it is a convenient alias for https://opda.org.uk/ns/; existing schema-derived material uses it for https://opda.org.uk/pdtf/. Never silently reinterpret that older binding. Show full IRIs or distinct aliases when discussing both corpora together.
VANN’s preferredNamespacePrefix and preferredNamespaceUri record preferred namespace bindings explicitly on the admitted vocabulary’s logical owl:Ontology resource. They do not prove that an organisation controls a domain, approve a definition or establish that two contexts share meaning. The context-map profile separately identifies a context, an identifier system it governs and, for a namespace-based system, the explicit namespace value. A context may govern multiple identifier systems.
That distinction makes governance queryable without treating a familiar prefix or substring as evidence. A namespace declares the intended naming boundary; the authoritative registry and reviewed model establish governance. An identifier-system resource is not interchangeable with the context resource or a named graph.
Stable identifiers are not file or release addresses
Keep four things distinct: a term IRI names a vocabulary resource; an individual IRI names a particular entity; an ontology IRI identifies a logical ontology; a document address identifies a document or representation. A named graph has its own graph name. None is automatically identical to a repository filename, directory or page route.
One namespace may span several files; one file may contain terms from several namespaces. Splitting a Turtle file, moving a source directory or redesigning this site therefore does not rename its terms. A graph can package statements from several contexts without becoming their semantic owner. The namespace policy is not a rule to create one graph or one document per context.
Nor does every release require a new term namespace. A corrected label can describe the same term; a changed definition may alter meaning and require a separate reviewed decision. Preserve established references, document deprecation and replacement where justified, and never quietly reuse an old IRI for a different meaning. Instance continuity likewise needs domain reasoning: correcting a report record is not automatically a new inspection.
The version inside the current candidate base belongs to that candidate’s identity. It does not prescribe /ns/v1/ for the selected policy. owl:versionInfo records version information; owl:versionIRI, when used, identifies a particular ontology version without renaming every term. Release identifiers, immutable version documents and delivery locations require their own explicit contracts; this policy does not invent their paths. Upstream’s dated operational graphs and versioned KB documents are scoped exceptions, not templates for OPDA domain identifiers.
What remains a governed decision
The topology answers where an admitted name belongs. Domain review must still establish its meaning, identity commitments and semantic home. Common-boundary promotion needs evidence of genuinely shared identity and meaning, not matching spelling or repeated use. A namespace table cannot supply that evidence.
For an instance family, record who may mint identifiers, the authoritative key convention, handling of collisions and composite keys, and what happens when a key is corrected or retired. Set normalisation and escaping rules before deriving IRIs from source values. Where these matters are unresolved, record the gap rather than presenting an illustrative identifier as production-ready.
Migration of existing corpora, public resolution and publication are separate authorised changes. This chapter makes no such change: the existing evidence and candidate remain inspectable under their original identifiers while the selected scheme guides future reviewed work.
Decision basis
ODR-0065: namespace topology and identifiers is the local authority for this policy and its scoped upstream adoption. Its source basis includes semantic-modelling’s ODR-0013, ODR-0020, ODR-0023, ODR-0024, ODR-0040, ODR-0055, ODR-0065 and ODR-0097, read with their amendments—not the upstream numbering as a substitute for an OPDA decision.
ADR-0067 governs first-principles coverage and semantic homes; ODR-0059 governs cross-context identity comparison; ODR-0064 distinguishes registered contexts, governed identifier systems and mapping applicability. The standards and decisions guide explains how status, scope and amendments determine authority.
Comments
Loading comments…
Sign in to post a comment