Discovery Index implemented
This index is the human front door to portal discovery. The generated source-doc inventory remains the machine-readable source, while this page explains how to use it.
Generated Artifacts
| Artifact | Use |
|---|---|
| Source-doc inventory JSON | Machine-readable page/source/owner/freshness mapping |
packages/docs/static/portal/source-doc-inventory.md | Reviewable generated inventory |
| OpenAPI YAML | REST contract artifact |
| AsyncAPI YAML | Event contract artifact |
| Scalar-compatible OpenAPI YAML | Renderer compatibility artifact generated from the REST contract |
Discovery Paths
| Need | Start |
|---|---|
| Find a page by audience | Internal Team Onboarding and section sidebars |
| Find a source doc | Source Doc Inventory |
| Find diagrams | Diagram Backlog plus reader pages |
| Find owners/freshness | Ownership And Freshness and generated inventory |
| Find publication track rules | Publication Filtering |
| Find review pack contents | Review Pack Export |
| Find API artifacts | Contract Artifacts |
Index Model
Future Filters
The next generated index should support filters for audience, owner, review-domain, status, freshness risk, source doc, diagram coverage, and publication track.