## Lesson — Promote migration guides to markdown headings

**Tags:** documentation, dx, markdown
**Scope:** docs/**/*.md

Using markdown headings for migration blocks improves discoverability and provides stable anchor links for cross-referencing in long reference documents.
