LCDL handbook publish report

Date: 2026-05-16

Updated

Summary

  • Information architecture: Reorganized docs/ into start/, tutorials/{101,201,301}/, guides/, reference/ (including operators/), enterprise/, agents/, contribute/, examples/. Added handbook home at index.md, hubs, tutorials, and reference/task-catalog.md.
  • Compatibility: Legacy flat paths under docs/*.md are short stub pages with hide_from_nav: true pointing to canonical targets (see DOCS-MIGRATION-MAP.md).
  • forge-autodoc: HandbookBuildConfig now supports nav_exclude_path_prefixes and link_check. The LCDL website build excludes src/forge_lcdl/contracts/ from the primary sidebar while still emitting contract HTML.
  • Quality gates: scripts/audit_docs_site.py (internal link check; optional --strict frontmatter). 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 --strict frontmatter once all legacy stubs are retired.