Skip to content

docs: five-tab menu and a clean landing page - #179

Merged
imran-siddique merged 1 commit into
mainfrom
docs/five-tab-nav
Sep 14, 2026
Merged

imran-siddique merged 1 commit into
mainfrom
docs/five-tab-nav

Conversation

@imran-siddique

Copy link
Copy Markdown
Member

ca2a.agentrust-io.com opened with eight top-level menu entries: Home, Quick Start, How It Works, Configuration, Tutorials, Specification, Testing and Project. Testing held one page, three entries were single pages beside sections, and the home page carried a left menu and a table of contents beside its landing cards. The AgenTrust docs sites are moving to one menu shape, and this applies it here.

Menu, before and after

  • Before: Home, Quick Start, How It Works, Configuration, Tutorials, Specification, Testing, Project.
  • After: Home, Get started, Specification, Guides, Project.
  • Get started holds Quick start, How it works and Configuration.
  • Specification keeps Overview first, then groups its 16 pages four apiece: Profile and transport, Delegation and policy, Attestation, and Conformance and failure.
  • Guides holds the five tutorials and Hardware validation, which was the only page under Testing.
  • Project holds Limitations, Roadmap, Governance, Technical charter, Sponsors, Contributing, Changelog, Security, Code of conduct and Privacy.
  • Labels move to sentence case. No file is renamed, so every URL is unchanged.

Theme and landing page

  • header.autohide is removed, leaving the feature set the other docs sites use: navigation.instant, tracking, tabs, tabs.sticky, sections, top, path, search.suggest, search.highlight, content.code.copy, content.tabs.link and toc.follow.
  • index.md front matter adds hide: [navigation, toc], so the home page renders full width with the tabs only. Inner pages keep both sidebars.

Checked

  • The 37 nav entries before and after are the same set; the diff is empty.
  • Replicated the Docs workflow: copied docs/ and the root allowlist into .docs_build, rewrote docs_dir, and built with the pinned requirements/docs.txt (mkdocs 1.6.1, mkdocs-material 9.7.7). The build exits 0, and --strict also exits 0 with no warnings.
  • In the built site the tabs read Home, Get started, Specification, Guides, Project on the home page and on /docs/concepts/. The home page's primary and secondary sidebars carry hidden; /docs/concepts/ shows both.
  • Headless Chrome screenshots of the home page and /docs/concepts/ at 1400x900 show the five tabs and the full-width landing.

Generated with Claude Code

https://claude.ai/code/session_013aK3gVWzNdcM3hZ2o2awK2

The menu had eight top-level entries (Home, Quick Start, How It Works,
Configuration, Tutorials, Specification, Testing, Project), with Testing
holding a single page.
The top-level menu is now the one every AgenTrust docs site shares: Home,
Get started, Specification, Guides, Project. No page was added or dropped;
the flattened page lists before and after are identical. header.autohide is
removed so the theme features match the other docs sites, and the home page
hides the left menu and the table of contents.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013aK3gVWzNdcM3hZ2o2awK2
@imran-siddique
imran-siddique merged commit ec42cec into main Sep 14, 2026
13 checks passed
@imran-siddique
imran-siddique deleted the docs/five-tab-nav branch September 14, 2026 21:02
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