docs(nav): the one page on the site with no nav entry - #205
Conversation
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>
|
❔ Contributor Check: UNKNOWN
Automated check by AgenTrust Contributor Check. |
imran-siddique
left a comment
There was a problem hiding this comment.
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.
What this changes
One line in
mkdocs.yml. No content change.docs/rfcs/a2a-delegation-profile.mdis the only one of the site's 48 pages with nonav: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 themdocs/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 touchmkdocs.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.mdlinks it,examples/delegation-link/README.mdlinks it, it is insitemap.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_buildassembled the waydocs.ymlassembles it, the samesedapplied todocs_dir,--strictadded:mainCHANGELOG, and the page itselfNothing 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, andsitemap.xmland the search index are identical in both.llms.txtis untouched by design rather than by omission: thellmstxtplugin takes an explicitsections:list, and that list names no RFC at all —composable-zk-assurance.mdis absent from it too.Type of change
Spec section
None. The RFC is a draft proposal that binds nothing, and its text is not modified.
Checklist
git commit -s)CHANGELOG.mdupdated (for any normative change) — n/a, no normative change<!-- CHANGED: #NNN — description -->in spec text — n/a