Preview release. These docs are a work in progress. Pages are still being written, links may break, and structure may shift without notice. Treat everything here as a draft and report issues on GitHub.
Historical docs index
This is a maintenance record for site contributors. If you’re an integrator, ignore this page and use the current docs in each project.
Documentation for the registry stack still lives in the individual source repos. This index classifies each entry so readers know which docs are authoritative today, which are historical context, and which are archive or vendored content.
Status values:
current: still authoritative for its topic; not yet migrated into these docs.historical: superseded or scope-replaced; keep as record, not as instructions.archive: vendored copy, pre-rename worktree content, or nested demo staging area.
Registry Relay docs
Section titled “Registry Relay docs”Paths in this table are relative to apps/registry-relay/.
All paths verified against commit aec4394 (registry-relay evidence packet).
| Path | Topic | Status |
|---|---|---|
README.md | Entry point: build, run, config, API routes, auth | current |
docs/api.md | Public API routes reference | current |
docs/configuration.md | Full configuration reference | current |
docs/metadata.md | Metadata publication surface | current |
docs/evidence-verification.md | Evidence offering verification | current |
docs/ops.md | Operations and deployment | current |
docs/provenance.md | Verifiable Credentials and provenance | current |
docs/development.md | Contributor and development guide | current |
STANDARDS_ASSUMPTIONS.md | Standards claims and boundaries | current |
docs/evidence-server-spec.md | Original evidence server design spec | historical |
docs/evidence-server-spec-review.md | Review pass on the original spec | historical |
docs/evidence-server-implementation-review-pass3.md | Reviewer findings, pass 3 | historical |
docs/evidence-server-implementation-review-pass4.md | Reviewer findings, pass 4 | historical |
docs/evidence-server-implementation-review-pass5.md | Reviewer findings, pass 5 | historical |
docs/evidence-offering-refactor-spec.md | Refactor spec for evidence offerings | historical |
docs/evidence-offering-refactor-spec-review.md | Review of the refactor spec | historical |
docs/evidence-offering-refactor-implementation-review.md | Implementation review pass 1 | historical |
docs/evidence-offering-refactor-implementation-review-pass2.md | Implementation review pass 2 | historical |
docs/metadata-and-evidence-repo-split-spec.md | Spec for splitting metadata and evidence into separate repos | historical |
docs/metadata-runtime-split-spec.md | Spec for splitting metadata rendering from runtime | historical |
docs/relay-metadata-core-integration-map.md | Integration map after the metadata-core split | historical |
docs/decentralized-evidence-demo-spec.md | Original decentralized demo spec | historical |
docs/odrl-policy-spec.md | ODRL policy design spec | historical |
docs/ogc-api-features-spec.md | OGC API Features design spec | historical |
docs/performance-load-testing-spec.md | Performance testing spec | historical |
demo/decentralized/ | Nested decentralized demo (compose, config, data, scripts, static-metadata) | archive |
Note on demo/decentralized/: The rename plan (Phase 4, Decision 6) specifies this directory
be collapsed to a one-line pointer README once Registry Lab absorbs any unique fixtures.
As of 2026-05-23 the directory still contains a full compose setup and has not been collapsed.
It is listed as archive because Registry Lab is the canonical demo going forward,
but unique fixtures must be migrated before deletion.
Registry Manifest docs
Section titled “Registry Manifest docs”Paths in this table are relative to apps/registry-manifest/.
All paths verified against commit 77125ec (registry-manifest evidence packet).
The plan listed these paths under registry-metadata/, the pre-rename directory name.
The directory is now registry-manifest/; the table uses the current name.
| Path | Topic | Status |
|---|---|---|
README.md | Library and CLI entry point, manifest model, renderers | current |
docs/repository-split.md | Background on the metadata/evidence split from Registry Relay | historical |
Registry Notary docs
Section titled “Registry Notary docs”Paths in this table are relative to apps/registry-notary/.
All paths verified against commit b4128a3 (registry-notary evidence packet).
The plan listed these paths under evidence-server/, the pre-rename directory name.
The directory is now registry-notary/; the table uses the current name.
| Path | Topic | Status |
|---|---|---|
README.md | Service overview, claim model, auth, build, run | current |
Registry Atlas docs
Section titled “Registry Atlas docs”Paths in this table are relative to apps/registry-atlas/.
All paths verified against commit e4092a1 (registry-atlas evidence packet).
The plan listed dataspace-atlas/README.md and dataspace-atlas/SPEC.md.
The directory is now registry-atlas/; the table uses the current name.
| Path | Topic | Status |
|---|---|---|
README.md | UI, fetch proxy, capability discovery, entry points | current |
SPEC.md | Original Atlas workbench specification | historical |
SYSTEM_CAPABILITY_DISCOVERY_SPEC.md | Capability discovery spec (V0.1) | current |
STANDARDS_ASSUMPTIONS.md | Standards scope and non-goals | current |
HOW_TO_TEST_V0_1.md | Manual test guide for v0.1 | historical |
SEMANTIC_ASSET_DISCOVERY_SPEC.md | Semantic asset discovery design spec | current |
SEMANTIC_ASSET_DISCOVERY_FACADE_SPEC.md | Facade layer spec | historical |
SEMANTIC_ASSET_DISCOVERY_SCHEMA.md | Schema reference for discovery artifacts | historical |
SEMANTIC_ASSET_DISCOVERY_README.md | Discovery readme (pre-integration) | historical |
SEMANTIC_ASSET_DISCOVERY_V0.1_RELEASE.md | V0.1 release notes | historical |
Registry Lab docs
Section titled “Registry Lab docs”Paths in this table are relative to apps/registry-lab/.
All paths verified against commit aaa6f80 (registry-lab evidence packet).
The plan listed these paths under decentralized-evidence-demo/, the pre-rename directory name.
The directory is now registry-lab/; the table uses the current name.
| Path | Topic | Status |
|---|---|---|
README.md | Demo topology, scripts, setup, scenarios | current |
vendor/registry-relay/ | Git submodule: Registry Relay source | archive |
vendor/registry-notary/ | Git submodule: Registry Notary source | archive |
Top-level apps/docs/ docs
Section titled “Top-level apps/docs/ docs”Paths in this table are relative to apps/docs/.
Path existence verified by direct filesystem check (2026-05-23).
| Path | Topic | Status |
|---|---|---|
docs/registry-discovery-evidence-standard.md | Discovery and evidence standard background | historical |
docs/registry-relay-dpi-safeguards.md | DPI safeguards background; candidate for a future explanation page | historical |
Omitted plan entries
Section titled “Omitted plan entries”The following paths appeared in the plan’s “Existing docs to triage” section but do not exist at the expected locations as of 2026-05-23:
registry-metadata/README.mdandregistry-metadata/docs/repository-split.md: Theregistry-metadatadirectory does not exist locally; it was renamed toregistry-manifest. Current paths are listed in the “Registry Manifest docs” section.evidence-server/README.md: Theevidence-serverdirectory does not exist locally; it was renamed toregistry-notary. The current path is listed in the “Registry Notary docs” section.dataspace-atlas/README.mdanddataspace-atlas/SPEC.md: Thedataspace-atlasdirectory does not exist locally; it was renamed toregistry-atlas. Current paths are listed in the “Registry Atlas docs” section.decentralized-evidence-demo/README.mdanddecentralized-evidence-demo/vendor/: Thedecentralized-evidence-demodirectory does not exist locally; it was renamed toregistry-lab. Current paths are listed in the “Registry Lab docs” section.