META: Rewrite and secure documentation for v0.2

[dclause]

Motivation:
Writing clear, maintainable, and up-to-date documentation is hard but essential.
This issue serves as a tracking task for the documentation overhaul in preparation for the upcoming v0.2 release.

Objectives:

• Migrate documentation from VitePress to Docusaurus #6
• Audit current documentation content
  • Identify outdated sections, missing topics, and inconsistencies
• Update visuals to match new branding
  • dark blue: #30475E
  • light blue: #0097A7 => lighten: #CBDDE1
  • orange: #FFAB40 => lighten: #FFE2CE
• Review / finalize the new logo
  • Export in both SVG and PNG (consider light/dark variants)

Contributions welcome!
Whether it's feedback, proofreading, or helping with new content, feel free to jump in !
Even small contributions make a big difference 🙏