Skip to content

Restructure docs IA#653

Open
ryanycoleman wants to merge 2 commits intostrands-agents:mainfrom
ryanycoleman:ia_redesign
Open

Restructure docs IA#653
ryanycoleman wants to merge 2 commits intostrands-agents:mainfrom
ryanycoleman:ia_redesign

Conversation

@ryanycoleman
Copy link
Member

@ryanycoleman ryanycoleman commented Mar 13, 2026

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

  • [X ] I have read the CONTRIBUTING document
  • [X ] My changes follow the project's documentation style
  • [X ] I have tested the documentation locally using npm run dev
  • [X ] Links in the documentation are valid and working

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

@github-actions
Copy link
Contributor

github-actions bot commented Mar 13, 2026

Documentation Preview Ready

Your 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

Copy link
Contributor

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 additionalBasePaths pattern for nav consolidation is clean and maintainable

The new API language switcher in the sidebar is a nice UX improvement. All tests pass. 🎉

@github-actions
Copy link
Contributor

Documentation Preview Failed

The documentation deployment encountered an error. Please check the deployment logs for more details.

@github-actions
Copy link
Contributor

Documentation Preview Failed

The documentation deployment encountered an error. Please check the deployment logs for more details.

@github-actions
Copy link
Contributor

Documentation Preview Failed

The documentation deployment encountered an error. Please check the deployment logs for more details.

@github-actions
Copy link
Contributor

Documentation Preview Failed

The documentation deployment encountered an error. Please check the deployment logs for more details.

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.
@ryanycoleman ryanycoleman changed the title Restructure docs IA and improve SEO fundamentals Restructure docs IA Mar 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant