From d8b81762922c2142c01f5bdd58c16dd1f72f48ff Mon Sep 17 00:00:00 2001 From: John Pham Date: Tue, 4 Aug 2026 17:59:27 -0500 Subject: [PATCH] Add responsible use to docs navigation Signed-off-by: John Pham --- docs/meta.json | 1 + scripts/check-docs.mjs | 12 +++--------- 2 files changed, 4 insertions(+), 9 deletions(-) diff --git a/docs/meta.json b/docs/meta.json index 91ce3852c..38b46588c 100644 --- a/docs/meta.json +++ b/docs/meta.json @@ -22,6 +22,7 @@ "guides", "concepts", "patterns", + "responsible-use", "reference" ] } diff --git a/scripts/check-docs.mjs b/scripts/check-docs.mjs index 8cd4ba39f..2a4534146 100755 --- a/scripts/check-docs.mjs +++ b/scripts/check-docs.mjs @@ -15,8 +15,8 @@ * every site-page markdown file must be reachable from the sidebar nav * — either listed by slug in an ancestor `meta.json#pages`, covered * by a `"..."` token in that array, or explicitly allowed as a - * footer-only page. Otherwise the page renders at its URL but never - * appears in the sidebar (easy to miss in review). + * `"..."` token in that array. Otherwise the page renders at its URL + * but never appears in the sidebar (easy to miss in review). * * Files intentionally not part of the site (the top-level engineer-facing * README.md in each root) are skipped via isExcluded(). @@ -34,16 +34,10 @@ const ROOTS = [ }, ]; -const SIDEBAR_EXEMPT_PAGES = new Set([ - // Linked from the global footer instead of the docs sidebar. - "responsible-use.md", -]); - // Only the top-level README.md is excluded. Nested READMEs (e.g. // channels/README.md) are site pages and must carry a `url:` frontmatter // override, validated below. const isExcluded = (relPath) => relPath === "README.md"; -const isSidebarExempt = (relPath) => SIDEBAR_EXEMPT_PAGES.has(relPath); function walkMarkdown(dir) { const out = []; @@ -176,7 +170,7 @@ for (const root of ROOTS) { issue: `frontmatter missing \`${field}\``, }); } - if (nav && !isSidebarExempt(relPath) && !isCoveredByNav(relPath, nav)) { + if (nav && !isCoveredByNav(relPath, nav)) { failures.push({ root: root.label, file: relPath,