docs: improve formatting and expand architecture details in migration guide

- Fix formatting inconsistencies and improve readability
- Add detailed architecture comparison between Media Chrome and VJS-10
- Expand on state management evolution with concrete examples
- Include migration rationale and design decisions
- Enhance code examples with better syntax highlighting

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: cjpillsbury