Skip to content

Conversation

@dbrian57
Copy link
Contributor

@dbrian57 dbrian57 commented Jan 9, 2026

Description

DRAFT

This PR updates the Weave side-nav to better reflect a user journey. Notable updates:

  • New Concepts section
  • Updated top-level titles for guide section
  • Flatter guide menus
  • New Details and Support section

@github-actions
Copy link
Contributor

github-actions bot commented Jan 9, 2026

📚 Mintlify Preview Links

🔗 View Full Preview

✨ Added (4 total)

📄 Pages (4)

File Preview
weave/details/features.mdx Features
weave/guides/getting-started/fundamental-components.mdx Fundamental Components
weave/guides/getting-started/what-is-weave.mdx What Is Weave
weave/guides/tracking/context-managers.mdx Context Managers

📝 Changed (1 total)

⚙️ Other (1)
File
docs.json

🤖 Generated automatically when Mintlify deployment succeeds
📍 Deployment: 0574ae2 at 2026-01-12 19:18:54 UTC

@adrnswanberg
Copy link
Contributor

Apologies in advance but it's easier for me to type a bunch of comments in here as I look at the preview vs finding the right spots to leave inline comments. Observations by section:

Get Started
I know you didn't touch this much in this work but I think this needs a look too.

  • Quickstart and "build an eval" are good. I would drop the word "pipeline" as it doesn't signal much.
  • Ideally we should replace "Evaluate RAG applications" with "Evaluate an agent" or something more contemporary. RAG is increasingly dated. The PMs can help with this.
  • I think we should drop "Learn Weave with W&B Inference". It does not help our users much and takes up space.

Concepts

  • "What is Weave?" is a nice page. It might be missing mention of playground though?
  • In "Fundamental Concepts" we should probably explain what we mean by weave.Model

Guides

  • I like the shift to using verbs in the section groups.
  • Inside "Track your application", should "tracing overview" be first?
  • "Version your work" is a great top-level group.
  • I would put stuff related to OTEL under "Monitor and collect feedback", as you'd primarily be using OTEL to log production traces.

Tutorials
Section name feels a little redundant since there are tutorials embedded inside the "Guides" section. I think "Cookbooks" might still be better here? I am also wondering to what extend we need this section since much of content overlaps with various "Guides" pages.

Everything else looks good.

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.

3 participants