Remove the minimal yml configuration example so users reference the full
config. Add a section explaining how headers generate left-nav tabs and
how to use Mermaid for diagrams.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>