Documentation Workflow

  • User-facing docs: edit under content/; register new top-level pages in mkdocs.yml → nav when they should appear in the site menu.
  • Internal agent docs: content/agents/ — use robots: noindex, nofollow in front matter; URLs under /agents/ are stripped from the public sitemap by scripts/postprocess_sitemap.py.
  • After substantive doc changes, run make check and update project/changelog/ when appropriate.