docs-discoverability-audit

Run a documentation discoverability audit that maps entry points, reviews page titles, headings, URLs, and internal links, then checks sitemap, robots, canonical, and redirect configuration. Findings are prioritized as Blocker, High, Medium, or Low with a recommended change plan.

Build a documentation map from the README, sidebar configuration, and docs directories, then flag pages missing from navigation, reachable only through deep links, or duplicating the same topic. Each duplicate set gets a recommendation to merge, redirect, label, or keep one canonical page.

Yes, the audit inspects navigation and routing configuration such as docusaurus.config, sidebars files, .vitepress/config, mkdocs.yml, and astro.config. It also reviews redirects, breadcrumbs, and search configuration defined by these documentation frameworks.

No, indexing cannot be confirmed from repository files alone. The audit classifies findings as Confirmed, Likely, or Unknown, and only reports indexing status when crawl reports, Search Console exports, or live deployment evidence is available.

Avoid it when you only need meta titles written, prose edited for grammar, or a single sitemap generated. It is also not suited for general content marketing strategy unrelated to technical documentation.