Conversation
Documentation Preview ReadyYour documentation preview has been successfully deployed! Preview URL: https://d3ehv1nix5p99z.cloudfront.net/pr-cms-653/docs/user-guide/quickstart/overview/ Updated at: 2026-03-17T20:32:11.188Z |
There was a problem hiding this comment.
Assessment: Comment
Solid improvements to IA and SEO. The navigation consolidation is sensible and the structured data implementation follows best practices.
Review Categories
- Code Quality: A few opportunities to reduce duplication (JSON-LD schemas) and improve error handling (sitemap plugin)
- SEO Implementation: Well-structured meta tags and JSON-LD schemas that should improve search visibility
- Architecture: The
additionalBasePathspattern for nav consolidation is clean and maintainable
The new API language switcher in the sidebar is a nice UX improvement. All tests pass. 🎉
Documentation Preview FailedThe documentation deployment encountered an error. Please check the deployment logs for more details. |
Documentation Preview FailedThe documentation deployment encountered an error. Please check the deployment logs for more details. |
Documentation Preview FailedThe documentation deployment encountered an error. Please check the deployment logs for more details. |
Documentation Preview FailedThe documentation deployment encountered an error. Please check the deployment logs for more details. |
ddbd343 to
efcd9b7
Compare
Nav tabs reduced from 9 to 5: merged Labs and Contribute into Community, merged Python API and TypeScript API into a single API Reference tab with a sidebar language switcher, renamed User Guide to Docs. Blog tab will be added by a separate PR. Sidebar reorganized with a new task-first "Build" section (Adding Tools, Using MCP Tools, Multi-Agent Systems, Streaming Responses, Voice & Realtime, etc.) positioned above Concepts. Deploy promoted from last to after Model Providers. Homepage CTA now links directly to the Python quickstart, skipping the overview routing page. New "Why Strands?" page with model-driven vs workflow-driven comparison, code examples, and a Python/TypeScript feature matrix. Initial draft — content needs refinement. Sidebar labels now sourced from navigation.yml rather than page frontmatter, so nav labels can differ from page titles without touching individual content files.
efcd9b7 to
5f6822f
Compare
Description
Information architecture restructure — Consolidate navbar from 9 tabs to 6 by folding Labs and Contribute under Community. Promote Model Providers and Deploy to top-level sidebar sections for
Checklist
npm run devBy submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.