Skip to content

docs(nav): the one page on the site with no nav entry - #205

Merged
imran-siddique merged 1 commit into
agentrust-io:mainfrom
lywinged:docs/nav-a2a-rfc
Aug 24, 2026
Merged

docs(nav): the one page on the site with no nav entry#205
imran-siddique merged 1 commit into
agentrust-io:mainfrom
lywinged:docs/nav-a2a-rfc

Conversation

@lywinged

Copy link
Copy Markdown
Collaborator

What this changes

One line in mkdocs.yml. No content change.

docs/rfcs/a2a-delegation-profile.md is the only one of the site's 48 pages with no nav: entry — 47 entries, 48 pages, and this is the page they do not cover.

This is also the same fix already applied once. 8380993"Adopt-the-shared-design-system-and-unhide-ten-pages", 2026-08-19 — added exactly ten nav entries, one of them docs/rfcs/composable-zk-assurance.md, which had landed in #162 three days earlier without one. #184 merged four days after that sweep and did not touch mkdocs.yml, so its RFC is in the state the sweep existed to clear. Nothing in #184's description, comments or reviews mentions the nav, so this reads as the same omission rather than a decision.

It is not unreachable, and this PR is not claiming that: CHANGELOG.md links it, examples/delegation-link/README.md links it, it is in sitemap.xml, and the search index carries 13 entries for it. What it has no path from is the navigation.

Measured by reproducing the deployed build rather than a local one — .docs_build assembled the way docs.yml assembles it, the same sed applied to docs_dir, --strict added:

exit warnings pages that link to it
main 0 none 2CHANGELOG, and the page itself
with the nav entry 0 none 49 — all of them, via the sidebar

Nothing else moves. Comparing the two site trees file by file: 49 files differ, none added, none removed, and no page loses a link. 48 of them gain exactly one — the sidebar entry. The forty-ninth is the RFC's own page, which gains 17: its table of contents, which the theme renders only for a page it navigates to. Its rendered <article> is byte-identical across the two builds, same SHA-256 and same 35,201 characters, and sitemap.xml and the search index are identical in both.

llms.txt is untouched by design rather than by omission: the llmstxt plugin takes an explicit sections: list, and that list names no RFC at all — composable-zk-assurance.md is absent from it too.

Type of change

  • Editorial (typo, link fix, clarification — no normative effect)
  • Non-breaking spec change (new optional field, new platform profile, informative addition)
  • Breaking spec change (requires 14-day comment period and Project Lead sign-off)
  • Schema change
  • Example addition

Spec section

None. The RFC is a draft proposal that binds nothing, and its text is not modified.

Checklist

  • DCO sign-off on all commits (git commit -s)
  • CHANGELOG.md updated (for any normative change) — n/a, no normative change
  • Breaking changes marked with <!-- CHANGED: #NNN — description --> in spec text — n/a
  • Backward compatibility statement included (for breaking changes) — n/a

47 nav entries, 48 built pages. docs/rfcs/a2a-delegation-profile.md is the page
they do not cover.

The same fix has been applied once already: 8380993
("Adopt-the-shared-design-system-and-unhide-ten-pages", 2026-08-19) added ten
nav entries, one of them docs/rfcs/composable-zk-assurance.md, which had landed
in agentrust-io#162 three days earlier without one. agentrust-io#184 merged four days after that sweep
and did not touch mkdocs.yml. Nothing in agentrust-io#184's description, comments or reviews
mentions the nav.

It is not unreachable — CHANGELOG.md links it, examples/delegation-link/README.md
links it, it is in sitemap.xml, and the search index carries 13 entries. What it
has no path from is the navigation.

Measured by reproducing the deployed build rather than a local one: .docs_build
assembled the way docs.yml assembles it, the same sed applied to docs_dir,
--strict added.

  baseline  rc=0, no warnings;  2 pages link to it (CHANGELOG, and itself)
  with nav  rc=0, no warnings; 49 pages link to it (all of them, via the sidebar)

Nothing else moves. 49 files differ, none added, none removed, no page loses a
link. 48 gain exactly one — the sidebar entry. The forty-ninth is the RFC's own
page, +17: its table of contents, which the theme renders only for a page it
navigates to. The rendered <article> is byte-identical across both builds
(sha256 4d5b3cf2d6e94551, 35201 chars); sitemap.xml and the search index are
identical in both.

llms.txt is untouched by design: the llmstxt plugin takes an explicit sections
list that names no RFC at all.

Signed-off-by: Louielunz <48041247+lywinged@users.noreply.github.com>
@lywinged
lywinged requested a review from a team as a code owner August 23, 2026 23:05
@github-actions

github-actions Bot commented Aug 23, 2026

Copy link
Copy Markdown
Contributor

Contributor Check: UNKNOWN

Check Result
Profile UNKNOWN
Credential LOW
Overall UNKNOWN

Automated check by AgenTrust Contributor Check.

@github-actions github-actions Bot added the needs-review:UNKNOWN Contributor check flagged UNKNOWN risk label Aug 23, 2026

@imran-siddique imran-siddique left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Verified the claim at pinned main 4785fa77: the nav carries 47 .md entries against 27 pages under docs/, and set-comparing the two lists leaves exactly one page uncovered, docs/rfcs/a2a-delegation-profile.md. That matches your description precisely.

The build evidence is the part that makes this easy to take: the RFC's rendered <article> is byte-identical across both builds, sitemap and search index unchanged, and the only delta is the sidebar entry plus the page's own table of contents. Nothing normative moves.

Non-blocking observation: the llmstxt sections: list naming no RFC at all is worth a separate look, since composable-zk-assurance.md is missing from it too. Not this PR's job.

Approving and merging.

@imran-siddique
imran-siddique merged commit dd8fbe9 into agentrust-io:main Aug 24, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs-review:UNKNOWN Contributor check flagged UNKNOWN risk

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants