Skip to content

Ia redesign#615

Closed
ryanycoleman wants to merge 1 commit intostrands-agents:mainfrom
ryanycoleman:ia_redesign
Closed

Ia redesign#615
ryanycoleman wants to merge 1 commit intostrands-agents:mainfrom
ryanycoleman:ia_redesign

Conversation

@ryanycoleman
Copy link
Member

This PR is a draft to solicit feedback on a first crack at reorganizing the documentation from concept-first to task-first, based on some lightweight information architecture research I did on the agent SDK and developer docs space (e.g. LangChain, Vercel, Stripe).

What changed:

  • 9 nav tabs → 6 — merged Labs + Contribute into Community, merged Python API + TypeScript API into API Reference (though this part needs verification with the build process), renamed User Guide →
    Docs
  • New "Build" section in sidebar — task-oriented entry points (Adding Tools, Using MCP Tools, Multi-Agent Systems, etc.) above Concepts
  • Deploy promoted from last sidebar section to after Model Providers
  • Homepage CTA links directly to Python quickstart (skips overview routing page)
  • New "Why Strands?" page — model-driven vs workflow-driven explainer with code comparison and feature matrix (initial draft / needs edits)
  • Sidebar labels now come from mkdocs.yml nav instead of page frontmatter titles (Astro would have us use frontmatter metadata but I wanted to keep this low-touch for now)

@ryanycoleman
Copy link
Member Author

This also builds on the blog commits that @zastrowm is pulling out separately. I'm opening this mostly for the preview link. Will move the IA commits to a fresh branch once we're settled.

@github-actions
Copy link
Contributor

github-actions bot commented Mar 7, 2026

Documentation Preview Ready

Your documentation preview has been successfully deployed!

Preview URL: https://d3ehv1nix5p99z.cloudfront.net/pr-cms-615/docs/user-guide/quickstart/overview/

Updated at: 2026-03-09T03:29:41.409Z

Navigation: 9 tabs → 6 (Home, Docs, Examples, Community, Blog, API Reference).
Labs and Contribute merged into Community. Python API and TypeScript API
merged into a single API Reference tab with collapsible language groups.

Sidebar: Add task-first "Build" section (Adding Tools, Creating Custom Tools,
Using MCP Tools, Multi-Agent Systems, Structured Output, Streaming Responses,
Voice & Realtime) above Concepts. Promote Deploy from last to after Model
Providers. Add "Get Started" section with direct quickstart links.

New content: "Why Strands?" explainer page with model-driven vs workflow-driven
comparison, code examples, and Python/TypeScript feature matrix.

Other: Homepage CTA links directly to Python quickstart (skip overview routing
page). Sidebar loader preserves mkdocs.yml nav labels instead of discarding
them. llms.txt section names updated.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@ryanycoleman
Copy link
Member Author

Closing in favor of #627 which is cleaner, leaner and based on the migrated CMS branch.

@ryanycoleman ryanycoleman deleted the ia_redesign branch March 12, 2026 22:30
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