Skip to content

Conversation

@dbrian57
Copy link
Contributor

@dbrian57 dbrian57 commented Nov 22, 2025

Description

Resolves DOCS-1478 and DOCS-1731. This adds a Weave projects overview page documenting how projects are structured and what they contain.

@dbrian57 dbrian57 requested a review from a team as a code owner November 22, 2025 20:02
@github-actions
Copy link
Contributor

Images automagically compressed by Calibre's image-actions

Compression reduced images by 69.6%, saving 56.3 KB.

Filename Before After Improvement Visual comparison
weave/guides/platform/imgs/weave-project.png 80.8 KB 24.6 KB 69.6% View diff

@github-actions
Copy link
Contributor

github-actions bot commented Nov 22, 2025

📚 Mintlify Preview Links

🔗 View Full Preview

✨ Added (1 total)

📄 Pages (1)

File Preview
weave/guides/platform/weave-projects.mdx Weave Projects

📝 Changed (1 total)

⚙️ Other (1)
File
docs.json

🤖 Generated automatically when Mintlify deployment succeeds
📍 Deployment: 8eb408c at 2025-12-17 17:40:12 UTC

docs.json Outdated
},
{
"group": "Enterprise",
"group": "Platform",
Copy link
Contributor

Choose a reason for hiding this comment

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

Should this stuff be moved over to the /platform docs?

Copy link
Contributor

@mdlinville mdlinville left a comment

Choose a reason for hiding this comment

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

Several small suggestions, and some feedback about the navigation, but this is a great addition.

{
"group": "Tools & Resources",
"pages": [
"weave/guides/platform/weave-projects",
Copy link
Contributor

Choose a reason for hiding this comment

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

This new page seems either oddly placed and/or oddly titled. It's too bad there are not more pages about projects, but how about just "Weave projects" fore a title?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yeah, I completely agree. I really couldn't find a better place to shoe-horn this in using the current IA. The IA desprerately needs work for stuff like this. I'm kinda stuck between a rock and hard place, because I have tickets that require this coverage, but the IA needs a huge amount of rework that requires not just reorganizing pages, but breaking them out in places and consolidating in others. It's a mess.

I'll think of something to do here.

@@ -0,0 +1,69 @@
---
title: "Weave projects overview"
description: "Weave projects are collections of traces, evaluations, models, and other Weave assets"
Copy link
Contributor

Choose a reason for hiding this comment

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

How about something like "Use Weave projects to organize related assets like traces, prompts, evaluations, models, and dashboards"? FYI the description also shows up at the top of the page content, so you may not need to duplicate it all in the first paragraph, depending on what you think about the preview.

- **[Ops](/weave/guides/tracking/ops)**: Automatically versioned and tracked functions decorated with `@weave.op()` that produce calls and maintain a record of function modifications.
- **Other objects and metadata**: Additional Weave objects, custom types, and associated metadata stored within the project.

## Creating and using projects
Copy link
Contributor

Choose a reason for hiding this comment

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

Aha, so there are tasks here after all, so maybe "Projects" is the right title for the page.

You could call this section "Work with projects", then you could have Create, View, Manage, Delete. Or you could have a section Projects with "Overview" and "Work with projects" or something like that. I'd prefer the non-gerund forms.

Access your projects in the Weave UI:

1. Navigate to [wandb.ai](https://wandb.ai)
2. Select your project from the **Projects** sidebar. This opens the project's overview page.
Copy link
Contributor

Choose a reason for hiding this comment

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

You could send them straight here in step 1.

Copy link
Contributor

Choose a reason for hiding this comment

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

Super minor, but the browser could be a bit narrower for this screenshot to improve the information density.

Co-authored-by: Matt Linville <matt.linville@wandb.com>
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.

4 participants