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.
Problems Registry Stack addresses
These are the failures the registry-stack family was built around. Read the page that matches what you are seeing. Each one names the problem, walks through why it recurs, and says what Registry Stack changes (and where it stops).
Problem pages
Section titled “Problem pages”Ordered by how directly Registry Stack changes the problem.
- Existing data is not service-ready: the data lives in a spreadsheet or a database, three teams email for copies, and three months later nobody can say which list is authoritative.
- APIs over-share records: the caller needs a yes/no, and the only available API hands them the whole record.
- Safeguards need technical enforcement: the data-sharing agreement is signed; the API has no purpose field, no scopes, no audit record, and the reviewer has nowhere to look.
- Integrations become one-off negotiations: every new caller asks the same questions, gets the same explanations in a fresh email thread, and the fourth integration costs as much as the first.
- Registry capabilities are hard to discover: integrators cannot see fields, schemas, or endpoints until they have signed an agreement and read a PDF nobody is sure still matches the runtime.
- Semantics do not line up: two registries expose a field
called
statuswith a codeactiveand mean different things by it; the integration code becomes the de facto definition. - Entity identity and matching are unclear: a registry answers “owner confirmed” without saying which record was matched, on what fields, or how confident the match was.
Related
Section titled “Related”- Capabilities: what Registry Stack lets an operator or reviewer do.
- Use cases: worked examples organized by role and situation.
- Architecture overview: system model and project boundaries.