Home / Check catalog / 3. Content Quality & Entity Semantics / 3.11 Documentation Structure Quality

3.11 Documentation Structure Quality

30 checks in Content Quality & Entity Semantics. AI-assisted Scored in the Deep Audit's AI analysis pass.

Documentation Structure & Hierarchy

IDCheckPasses whenWeightRuns
3.11.01Validate website content follows a consistent documentation structure (headings hierarchy, section clarity)Consistent H1-H6 hierarchy across pagesCriticalDeterministic + AI
3.11.02Validate cross-references between pages use descriptive anchor text and contextual linkingNo generic "click here" linksHeavyDeterministic + AI
3.11.03Validate documentation pages include table of contents or page-level navigationTOC present on pages > 1500 wordsHeavyDeterministic + AI
3.11.04Validate documentation has a clear entry point (index/overview page) that maps the full content hierarchyEntry point page presentHeavyDeterministic + AI
3.11.05Validate documentation pages have clear breadcrumbs reflecting content hierarchyBreadcrumbs present and accurateMediumDeterministic + AI
3.11.06Validate documentation sections have consistent formatting patterns (intro, body, summary)Consistent patternsMediumDeterministic + AI
3.11.07Validate documentation uses versioning or update timestamps visible to readers and AIDates or version info presentMediumDeterministic + AI
3.11.08Validate documentation depth matches topic complexity (simple topics concise, complex topics thorough)Appropriate depthHeavyDeterministic + AI
3.11.09Validate documentation avoids orphan pages (all doc pages reachable from the hierarchy)Zero orphan doc pagesMediumDeterministic + AI
3.11.10Compute Documentation Structure & Hierarchy composite scoreFinalizedCriticalDeterministic + AI

Content Taxonomy & Coherence

IDCheckPasses whenWeightRuns
3.11.11Validate content categories, tags, and taxonomies are machine-parseable and consistent across the siteConsistent taxonomyCriticalDeterministic + AI
3.11.12Validate category pages have proper meta descriptions and structured dataCategory schema presentHeavyDeterministic + AI
3.11.13Validate tag naming follows a consistent convention (no duplicates, no typos, no overlaps)Clean taxonomyHeavyDeterministic + AI
3.11.14Validate taxonomy depth is manageable (not > 4 levels deep)Depth <= 4MediumDeterministic + AI
3.11.15Validate taxonomy is reflected in URL structureURLs mirror taxonomyMediumDeterministic + AI
3.11.16Validate content-to-category mapping is complete (no uncategorized content)Zero uncategorized pagesHeavyDeterministic + AI
3.11.17Validate taxonomy supports AI extraction (categories mentioned in structured data)Category data in schemaMediumDeterministic + AI
3.11.18Validate related content links are accurate and contextually relevantRelevant related linksMediumDeterministic + AI
3.11.19Validate faceted navigation does not create duplicate content or crawl trapsCanonical tags on faceted pagesMediumDeterministic + AI
3.11.20Compute Content Taxonomy & Coherence composite scoreFinalizedCriticalDeterministic + AI

API Documentation & Knowledge Base AI-Readiness

IDCheckPasses whenWeightRuns
3.11.21If business exposes APIs, validate documentation follows OpenAPI/Swagger standardsOpenAPI spec present and validHeavyDeterministic + AI
3.11.22Validate API documentation is auto-discoverable (linked from site, referenced in structured data)DiscoverableHeavyDeterministic + AI
3.11.23Validate API documentation includes request/response examplesExamples presentMediumDeterministic + AI
3.11.24If business has a help center or knowledge base, validate it uses FAQ schema and QA pairsFAQ/QA schema presentHeavyDeterministic + AI
3.11.25Validate knowledge base articles have clear hierarchy (category > subcategory > article)Clear hierarchyHeavyDeterministic + AI
3.11.26Validate knowledge base search functionality returns relevant resultsRelevant search resultsMediumDeterministic + AI
3.11.27Validate knowledge base articles are updated within the last 12 monthsFresh contentMediumDeterministic + AI
3.11.28Validate knowledge base content is extractable by AI (not behind login walls or JS rendering)Publicly crawlableHeavyDeterministic + AI
3.11.29Validate knowledge base uses consistent formatting that AI models can parse (headings, lists, code blocks)AI-parseable formatMediumDeterministic + AI
3.11.30Compute API & Knowledge Base AI-Readiness composite scoreFinalizedHeavyDeterministic + AI

← 3.10 AI Agent Readiness3.12 Context Engineering for Web Content →

Run these checks on your site

A Deep Audit scores every check here that applies to your page, then an AI pass of up to 150 checks. Included on Pro and Ultra, or $9 for one audit.

See plans

Machine-readable: catalog totals and the full catalog as JSON (IDs, section, weight, status).