Move publishing to ard.json, remove the AI Catalog page - #19
Merged
Conversation
ARD v0.91 defines its own entry and its own manifest, and names one well-known path. The site is brought in line. Removed docs/ai_catalog_spec.md and its Specifications nav entry; the old URL redirects to interoperability.md. A top-level page devoted to ai-catalog overstated a coupling that v0.91 loosens and that will keep weakening. Every /.well-known/ai-catalog.json reference is now ard.json, across the publishing guide, get started, FAQ, interoperability, glossary and reference implementations. index.md and how_ard_works.md no longer credit the AI Catalog standard as the way resources are described. Glossary: "Capability manifest" (removed in v0.91) becomes "ARD manifest", a new "ARD entry" term is added, and "AI Catalog" is reframed as a separate, predating standard. Also corrects urn:ai: -> urn:air: in 7 places across glossary, FAQ and the client guide; the spec uses urn:air: throughout and 1404d7c fixed only the publishing guide. The publishing template drops specVersion and host: ardManifest requires only entries, and the Host Info Object was removed in v0.91. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Brings the site in line with ARD v0.91, which defines its own entry and manifest and names one well-known path.
docs/ai_catalog_spec.mdremoved, dropped from the Specifications nav; the old URL redirects tointeroperability.md./.well-known/ai-catalog.jsonreference is noward.json, across the publishing guide, get started, FAQ, interoperability, glossary, and reference implementations.index.mdandhow_ard_works.mdno longer credit the AI Catalog standard as the way resources are described.specVersionandhost—ArdManifestrequires onlyentries, and the Host Info Object was removed in v0.91.urn:ai:→urn:air:in 7 places; 1404d7c fixed only the publishing guide.The Cisco and Ora
curlexamples point atard.jsonand will 404 until those publishers serve it; both maintainers have been contacted.mkdocs build --strictpasses: no broken links, the redirect emits, nav renders without the AI Catalog entry.Companion: ards-project/ard-spec#81. The two should land together — the spec page renders
spec/ard.mdfrom that repo at build time.🤖 Generated with Claude Code