Skip to content

docs: give the site its own landing page instead of rendering the README - #125

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 rendering the README#125
imran-siddique merged 1 commit into
mainfrom
docs/site-landing-page

Conversation

@imran-siddique

Copy link
Copy Markdown
Member

ca2a.agentrust-io.com was the GitHub README rendered verbatim: a centered logo, a centered link row, four shields, and a Developer Preview note before any content. This brings it onto the pattern Agent Manifest already uses and TRACE and cMCP are moving to.

  • New index.md: what cA2A is, the gap A2A's Signed Agent Card leaves, the four primitives, a four-card "where to start", and how it fits the rest of the stack. README.md stays the GitHub landing page and is excluded from the build.
  • The hardcoded homepage title moves out of overrides/main.html into front matter, and the override goes.
  • The README Documentation badge pointed at agentrust-io.github.io/ca2a, one redirect behind the canonical domain.

Broken links fixed

PRIVACY.md was in the nav, and CHARTER.md and SECURITY.md were linked from GOVERNANCE.md, CONTRIBUTING.md and docs/spec/conformance.md. All four were excluded from the build, so all four 404'd on the live site. Now published, with Charter, Code of Conduct and Security in the nav.

Build goes from four warnings to clean under --strict.

🤖 Generated with Claude Code

https://claude.ai/code/session_013EQx4N5BzTQbY8kvXUsdkY

ca2a.agentrust-io.com was the GitHub README verbatim: a centered logo,
a centered link row, four shields, and a Developer Preview note, before
any content.

- Adds index.md as the site landing page: what cA2A is, the gap A2A's
  Signed Agent Card leaves, the four primitives, a four-card "where to
  start", and how it fits the rest of the stack. README.md stays the
  GitHub landing page and is excluded from the build.
- Moves the hardcoded homepage title out of overrides/main.html and
  into front matter, and removes the override.
- Points the README Documentation badge at ca2a.agentrust-io.com rather
  than the github.io URL that redirects to it.

Broken links fixed: PRIVACY.md was in the nav, and CHARTER.md and
SECURITY.md were linked from GOVERNANCE.md, CONTRIBUTING.md and
docs/spec/conformance.md, but all four were excluded from the build and
404'd on the live site. Published, with CHARTER, CODE_OF_CONDUCT and
SECURITY added to the nav.

Builds clean under --strict, from four warnings.

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:59
@imran-siddique
imran-siddique merged commit ff8b8bf 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