New website

[amacneil]

1. Migrated MCAP website from mkdocs to docusaurus

   • Consistent with what we are using to generate Foxglove API docs
   • Ability to easily integrate React components, with full support for server side rendering
   • Foxglove team has much more familiarity with TypeScript/React than Python
   • Cleaner URLs

2. Migrated hosting from GitHub Pages to Cloudflare Pages

   • Supports PR preview deployments

3. Removed self-hosted rust docs in favor of https://docs.rs/mcap/

   • Easier to show the latest released version (not main) and browse docs from previous versions
   • Same pattern we use for Go docs

4. Updated copy

   • New homepage
   • Integrated mcap CLI docs into website
   • Fixed links and formatting due to website migration

Preview deployment here: https://adrian-website.mcap.pages.dev/

[jtbandes]

still got some green

[amacneil]

👍 I think the CLI docs seem out of place under guides, I'd put them as another heading in the topnav.

Yeah I tried this, it felt pretty lonely (e.g. left sidebar only has one item). If the CLI docs were fleshed out with multiple pages of content I think it would work. Could always do that later.

[amacneil]

still got some green

I decided to embrace the green and remove the purple. It looks decent for now and we can always change colors in a follow up PR.

[jtbandes]

Why Cloudflare Pages as opposed to GitHub pages or something else?

[amacneil]

Why Cloudflare Pages as opposed to GitHub pages or something else?

Per PR description - "Supports PR preview deployments", that is the only reason. GitHub Pages seems to be an abandoned product, surprised they haven't shipped more features to become competitive with Vercel etc.

I did originally use Vercel for the deployment, but wasn't excited that they share a deploy key across all projects in the org which seemed non-ideal for security.