Summary
Audit the developer site information architecture to distinguish official reference documentation from opinionated guides and getting-started content.
Context
The developer site update discussion identified confusion between docs, guides, generated API/reference material, and supplemental walkthroughs. The team agreed this is valuable but larger than the first site organization pass.
Scope
- Review each top-level docs section for guide-like versus reference-like content.
- Propose a clearer taxonomy for documentation, guides, and getting-started material.
- Include transforms in the review, since transforms currently mix reference-like and guide-like content.
- Identify redirects or sidebar changes needed for a future implementation.
Summary
Audit the developer site information architecture to distinguish official reference documentation from opinionated guides and getting-started content.
Context
The developer site update discussion identified confusion between docs, guides, generated API/reference material, and supplemental walkthroughs. The team agreed this is valuable but larger than the first site organization pass.
Scope