Handbook

Workflow — docs refactor

bash python3 scripts/fix_docs_internal_links.py python3 scripts/resolve_doc_basenames.py

Updated

  1. Edit canonical Markdown under the nested IA (docs/start/, docs/guides/, …), not only legacy stubs at docs/*.md.
  2. Preserve bookmarks — either keep a one-line stub with hide_from_nav: true or add a forward link (see DOCS-MIGRATION-MAP).
  3. Update internal links — prefer relative paths; after bulk moves run:

bash python3 scripts/fix_docs_internal_links.py python3 scripts/resolve_doc_basenames.py

  1. Run python3 scripts/audit_docs_site.py until clean.
  2. Rebuild the static site from forge-lcdl-website per Website publishing.

Prompt snippet (for agents)

Refactor LCDL docs: no secrets; no Mermaid in handbook pages; run audit_docs_site.py; mirror docs/ into forge-lcdl-website submodule per publishing doc.

See also