docs: give the site its own landing page instead of rendering the README - #194
Merged
Conversation
trace.agentrust-io.com was the GitHub README verbatim: a centered icon, a five-line H1, six shields in colours the editorial palette does not use, and a "Full Documentation" badge linking to the page the reader is already on. About a screen and a half of chrome before the first sentence of content. - Adds index.md as the site landing page, in the shape Agent Manifest already uses: title, lead paragraph, the promise, a TL;DR, the claim table, a four-card "where to start", and status and governance. README.md stays the GitHub landing page and is excluded from the build so the project does not have two homepages. - Removes the htmltitle override in overrides/main.html, which only existed because README.md could not carry front matter, and lets the OG and Twitter titles use the real page title on the homepage too. Fixes found while doing it: - CODE_OF_CONDUCT.md, MAINTAINERS.md and CHARTER.md were linked from GOVERNANCE.md and ROADMAP.md but excluded from the build, so all three 404'd on the live site. Now published and in the nav. - docs/conformance-method.md was written but unreachable: not in the nav and not linked from anywhere. Now under Method. - The Spec badge said v0.1 while linking to, and describing, v0.2. - "Launching at Confidential Computing Summit, June 23 2026" read as a future event two months after the fact. - A crosswalk link to tests/test_acta_fixtures.py 404'd, because tests/ is not part of the published site. Points at GitHub now. The docs build goes from nine link warnings to zero. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013EQx4N5BzTQbY8kvXUsdkY
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.
trace.agentrust-io.comwas the GitHub README rendered verbatim: a centered icon, a five-lineH1, six shields in colours the editorial palette does not use, and a "Full Documentation" badge linking to the page the reader is already on. Roughly a screen and a half of chrome before the first sentence of content. Agent Manifest already does this properly with a purpose-writtenindex.md; this brings TRACE onto that pattern.Landing page
index.md: title, lead paragraph, the promise in one line, a TL;DR block, the claim table, a four-card "where to start", and status and governance.README.mdstays the GitHub landing page and is excluded from the build, so the project no longer has two homepages.htmltitleoverride inoverrides/main.html. It existed only becauseREADME.mdcould not carry front matter without rendering YAML as noise on GitHub. The OG and Twitter titles now use the real page title on the homepage too.Fixes found along the way
CODE_OF_CONDUCT.md,MAINTAINERS.md,CHARTER.mdlinked from GOVERNANCE/ROADMAP but excluded from the build, so all three 404'd livedocs/conformance-method.mdwritten but unreachable: not in nav, not linked anywherev0.1while linking to and describing v0.2tests/test_acta_fixtures.py404'd (tests/is not published)The docs build goes from nine link warnings to zero.
Verified by reproducing the CI build locally (
.docs_build+docs_dirrewrite) and viewing the result.🤖 Generated with Claude Code
https://claude.ai/code/session_013EQx4N5BzTQbY8kvXUsdkY