Skip to main content

Documentation reorganized around tasks

Peter Ekhator
ImprovedDocs

One sidebar, fourteen sections, organized around what you're trying to do — deploy a service, manage data, expose a domain, watch logs. Replaces the previous tab-strip of six sections.

What changed​

The docs site used to split navigation across six top-level tabs (Getting Started, Features, Console, Platform, Support, References). You'd jump between sidebars depending on which tab you landed on, and a single feature could appear in two places with subtly different content.

Now there's one sidebar that travels with you everywhere on computesphere.com/docs. Top-level sections track the customer journey:

  • Introduction — welcome, quickstart, concepts, API keys
  • Deployments — full lifecycle, environments, health checks
  • Datastores — Postgres, Valkey, MySQL, RabbitMQ
  • Storage — persistent disks, SphereStor, SphereFiles
  • Networking, Scaling, Observability, Integrations — task-grouped
  • Console, CLI, Platform, API errors, Support — reference

URLs didn't change. Bookmarks and AI-agent links keep working.

Why this matters​

Premium dev-tool docs (Render, Vercel, Linear) all use a single task-first sidebar. We've followed suit. Skimming for "how do I add a custom domain?" should not require knowing which tab the author filed it under.