refactor: AsciiDoc linter integration and semantic definition lists

[raifdmueller]

Summary

Complete AsciiDoc linter integration with semantic restructuring of all anchor files.

Changes

AsciiDoc Linter Integration 🔍

• Installed AsciiDoc linter from docToolchain
• 1011 → 0 linter violations across all anchor files
• All 92 anchor files now pass validation

Semantic Restructuring 📝

Before (non-semantic bullet lists):

*Core Concepts*:
* *Lightweight documentation*: Short, focused records
* *Immutability*: ADRs are never deleted

After (semantic definition lists):

*Core Concepts*:

Lightweight documentation:: Short, focused records

Immutability:: ADRs are never deleted

Specific Improvements

• Convert bullet lists with bold labels to definition lists (Label::)
• Use nested definition lists (Label:::) for hierarchical structures
• Fix explicit numbering (1. 2. 3.) to auto-numbering (. . .)
• Remove excessive blank lines
• Update template with correct structure

Additional Fixes

• Router: Handle /anchor/:id deep links (shared links now open modal)
• AsciiDoc quality: All files follow semantic best practices

Benefits

• Cleaner structure: Definition lists are semantically correct
• Better rendering: Many tools render definition lists with better formatting
• Consistency: All anchors follow the same pattern
• Maintainability: Linter ensures quality standards

Testing

• All 92 files pass asciidoc-linter validation
• Template updated with correct patterns
• Deep links tested and working

🤖 Generated with Claude Code