Skip to content
Registry stack docs v0 · draft

Describe registries

Describe registries is how a registry owner publishes a machine-readable description of what they offer, datasets, schemas, services, policies, and evidence offerings, before any integration is written. The primary implementation is Registry Manifest, which compiles a portable metadata.yaml manifest into catalogs, schemas, service descriptions, policy documents, evidence offerings, and an index.json discovery entry point.

Registry Manifest renders:

  • A DCAT/BregDCAT-AP catalog and dataset entries.
  • CPSV-AP service description.
  • CCCEV evidence offering definitions.
  • SHACL and JSON Schema shape files.
  • ODRL policy documents.
  • An index.json discovery entry point consumed by Registry Atlas.

Registry Relay can also serve Manifest-rendered metadata at runtime, filtered to the authenticated caller’s metadata scopes. Registry Manifest does not read registry records, open an HTTP listener, or grant credentials.

Registry Manifest: renderer, validation, and profile fixture model.

Start with the manifest schema reference. To publish, run the Manifest compiler against your metadata.yaml. To inspect the output, use Registry Atlas. To serve runtime metadata to authenticated callers, configure Registry Relay.

Example: a property registry run by a national land authority publishes a manifest declaring its parcels dataset, the parcel-identifier field, the freshness window, and the evidence offerings available against it.