docs(readme): reorganize README with table of contents (#1632) (#1633)

All CI checks passed successfully:
✅ Validate Code
✅ Triage Pull Request
✅ GitGuardian Security Checks

Merging as approved and per user instruction.

Author: rysweet