Skip to content

docs: give the site its own landing page instead of a repo index - #538

Merged
imran-siddique merged 1 commit into
mainfrom
docs/site-landing-page
Aug 21, 2026
Merged

docs: give the site its own landing page instead of a repo index#538
imran-siddique merged 1 commit into
mainfrom
docs/site-landing-page

Conversation

@imran-siddique

Copy link
Copy Markdown
Member

cmcp.agentrust-io.com opened on docs/README.md, which was written for someone browsing the repository: "This repository contains the product specification", a reading order by file path, a spec file index with issue numbers, and a note that implementation lives in a separate repo "(link TBD)" while cmcp-runtime is on PyPI.

  • New docs/index.md landing page in the shape Agent Manifest and TRACE now use: what cMCP is, the gap it closes, a TL;DR that states the two bounds up front, a four-card "where to start", and how it fits the rest of the stack.
  • The old page is kept, not deleted: it becomes docs/spec-index.md ("Specification index"), which is what it actually was. It keeps the spec file table, the schema table, the conformance test description and the glossary, and is now in the nav.
  • Fixes the "(link TBD)" scope note, which contradicted the published runtime.
  • The README Documentation badge pointed at agentrust-io.github.io/cmcp, one redirect behind the canonical cmcp.agentrust-io.com.
  • OG and Twitter titles no longer suppress the homepage title, now that the homepage has a real one.

Builds clean under mkdocs build --strict.

🤖 Generated with Claude Code

https://claude.ai/code/session_013EQx4N5BzTQbY8kvXUsdkY

cmcp.agentrust-io.com opened on docs/README.md, a page written for
someone browsing the repository rather than someone arriving at the
docs site: a reading order by file path, a spec index with issue
numbers, and a scope note saying implementation lives elsewhere
"(link TBD)" while cmcp-runtime is published on PyPI.

- Adds docs/index.md as the landing page, matching the shape Agent
  Manifest and TRACE use.
- Renames docs/README.md to docs/spec-index.md and puts it in the nav.
  The spec file table, schema table, conformance tests and glossary are
  worth keeping; they were just not a homepage.
- Corrects the "(link TBD)" scope note.
- Points the README Documentation badge at cmcp.agentrust-io.com rather
  than the github.io URL that redirects to it.
- Lets the social card titles use the homepage title.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013EQx4N5BzTQbY8kvXUsdkY
@imran-siddique
imran-siddique requested a review from a team as a code owner August 21, 2026 00:58
@imran-siddique
imran-siddique merged commit fd24ef7 into main Aug 21, 2026
12 checks passed
@imran-siddique
imran-siddique deleted the docs/site-landing-page branch August 21, 2026 01:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant