Skip to content

Conversation

@abrichr
Copy link
Member

@abrichr abrichr commented Jan 17, 2026

Summary

  • Fix broken link to architecture-evolution.md - changed ./docs/architecture-evolution.md to ../architecture-evolution.md (correct relative path from docs/design/)
  • Add explicit anchor IDs to all numbered section headings (1-8) using the {#anchor-id} syntax to ensure TOC links work correctly in MkDocs strict mode

Background

The CI was failing with:

WARNING -  Doc file 'design/production-execution-design.md' contains a link './docs/architecture-evolution.md', but the target 'design/docs/architecture-evolution.md' is not found among documentation files.
INFO    -  Doc file 'design/production-execution-design.md' contains a link '#7-implementation-roadmap', but there is no such anchor on this page.
INFO    -  Doc file 'design/production-execution-design.md' contains a link '#8-references', but there is no such anchor on this page.

Test plan

  • Verify mkdocs build --strict passes in CI
  • Verify TOC links navigate correctly in the rendered documentation

🤖 Generated with Claude Code

- Fix broken link to architecture-evolution.md (./docs/ -> ../)
- Add explicit anchor IDs to all numbered section headings to ensure
  TOC links work correctly with MkDocs strict mode

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants