Handbook
LCDL handbook publish report
Date: 2026-05-16
Updated
Summary
- Information architecture: Reorganized
docs/intostart/,tutorials/{101,201,301}/,guides/,reference/(includingoperators/),enterprise/,agents/,contribute/,examples/. Added handbook home atindex.md, hubs, tutorials, andreference/task-catalog.md. - Compatibility: Legacy flat paths under
docs/*.mdare short stub pages withhide_from_nav: truepointing to canonical targets (seeDOCS-MIGRATION-MAP.md). - forge-autodoc:
HandbookBuildConfignow supportsnav_exclude_path_prefixesandlink_check. The LCDL website build excludessrc/forge_lcdl/contracts/from the primary sidebar while still emitting contract HTML. - Quality gates:
scripts/audit_docs_site.py(internal link check; optional--strictfrontmatter). Contract audits unchanged (audit_contract_docs.py).
Commands run (verification)
python3 scripts/audit_docs_site.py
python3 -m pytest tests/docs/test_audit_docs_site_smoke.py -q
# in forgesdlc-kitchensink/forge-autodoc:
python3 -m pytest tests/test_nav_exclude.py -q
Website repo
Mirror forge-lcdl into forge-lcdl-website/forge-lcdl (subtree rsync), then from forge-lcdl-website: python3 generator/build-site.py — see contribute/WEBSITE-PUBLISHING.md.
Follow-ups
- Contract Markdown heuristic gaps from
audit_contract_docs.py(pre-existing count) can be reduced over time. - Optional: tighten
--strictfrontmatter once all legacy stubs are retired.