Generated Docs Audit

Audit generated HTML, Markdown, crawler controls, model-readable docs, structured data, API specs, and URL-class drift from one local source graph.

jmagly Updated

File contents

Generated Docs Audit

Run the CI-friendly local auditor:

npm run docs:discoverability:audit -- --root <generated-site> --json

Use a reviewed aiwg.docs-discoverability/v1 source graph. Treat failed crawl, index, or AI-discoverability controls as release blockers; review warnings for orphan, thin, stale, near-duplicate, and doorway-shaped output.

Do not present a local pass as hosted or multi-site governance. See docs/guides/generated-docs-discoverability-audit.md for the graph schema, severity rules, and public/enterprise boundary.

jmagly/ai-writing-guide/tree/main/agentic/code/plugins/doc-intelligence/skills/generated-docs-audit commit 7556851880

Frequently asked questions

npx skillmds@latest add jmagly-ai-writing-guide/generated-docs-audit