1. Project Overview & Quickstart (wandb/THIRD-PARTY-NOTICES.txt)
THIRD-PARTY-NOTICES.txt
Open-source repository wandb/THIRD-PARTY-NOTICES.txt
Repository Details
- Repository: wandb/THIRD-PARTY-NOTICES.txt
- Primary Language: Code
Note: High-volume repository documentation is actively indexed and synchronized by YakaAI.
2. Official Technical Reference & Guides (wandb/docs)
Weights & Biases Documentation
The Weights & Biases Docs (https://docs.wandb.ai/) is built using Mintlify, a static website generator. The high level overview of the doc writing process is:
- Edit the desired files.
- Create a pull request proposing your changes.
- Confirm that all CI checks pass to ensure that your changes donβt break the docs.
- Respond to feedback from the W&B docs team and CI checks.
After this, someone from the docs team will merge the PR and it will go live in a matter of minutes!
Quickstart
This section shows how to edit a page or report a bug from within your browser without cloning the repository or installing anything locally. To edit multiple files or build the documentation locally, refer to the Prerequisites and the following sections.
Edit a page
To edit a page you're reading on docs.wandb.ai, scroll to the bottom of the page and click Edit page to open the Markdown file in the GitHub editor.
To edit a page from https://github.com/wandb/docs, browse to or search for the page, then click the pencil icon to open the Markdown file in the GitHub editor.
Edit the page, then click Commit changes. In the dialog, choose to create a new branch, then specify:
- A name for the branch
- A commit message that describes the change. By default, this becomes the pull request title.
- An optional extended description. By default, this becomes the pull request body.
Click Propose change. A new branch is created with the commit you just created. A new dialog opens where you can create a pull request.
Optionally edit the pull request's title and description. Markdown is allowed. You can refer to a PR or issue by number or URL, and you can refer to a JIRA issue by its ID.
Click Create pull request. A member of @docs-team reviews your changes, provides feedback, and works with you to merge the change.
Report a bug
If you work for CoreWeave or Weights & Biases, file a doc JIRA, using the template at https://coreweave.atlassian.net/jira/core/projects/WBDOCS/form/2725.
To report a bug on a page you're reading on docs.wandb.ai:
- Scroll to the bottom of the page and click Report issue.
- Provide a title and optionally edit the description, then click Create.
To report a bug from https://github.com/wandb/docs:
- Click the Issues tab.
- Click New issue. Optionally select a template, then click Create.
- Provide a title and a description. If applicable, include the URL of the page with the bug. Click Create.
Prerequisites
The mint CLI is required for local builds. See https://www.mintlify.com/docs/installation. Install it from npx or from Homebrew.
macOS
After cloning this repo:
cdinto the clone.Create a working branch:
shellgit checkout -b my_working_branch origin/mainBuild and serve the docs locally:
shellmint devBy default, content is served from
https://localhost:3000/.Check for broken links and images:
shellmint broken-linksPush your branch to
origin:shellgit push origin my_working_branchThe first time you push a new branch, the terminal output includes a link to create a PR. Click the link and create a draft PR. CI tests will run.
When you are satisfied with your PR and all tests pass, click Ready for review to convert the draft PR to a reviewable PR. A member of the W&B docs team will review your changes and give feedback.
When all feedback is addressed and the PR is approved, the reviewer will merge the PR.
Exiting `mint dev`
To interrupt the Mintlify server, type CTRL+C in the terminal where it is running.
Mintlify compatibility
Mintlify processes Markdown files in .mdx format, which has stricter requirements than .md. If a file contains incompatible Markdown, mint dev will fail and mint broken-links will show errors. For example, HTML comments (``) are not supported. Instead, use this syntax for comments: {/* like this */}.
For general guidelines, refer to the Create content section of the Mintlify documentation. For example:
This list of links is not exhaustive. Check the Mintlify documentation for full details.
How to edit the docs locally
Navigate to your local clone of this repo and pull the latest changes from main:
bashgit pull origin mainCreate a feature branch off of
main.bashgit checkout -b <your-feature-branch>After installing the prerequisites documented above, start a local preview of the docs.
bashmint devThis will return the localhost URL and port number where you can preview your changes to the docs as you make them (e.g.
https://localhost:3000).Make your changes on the new branch.
Check your changes are rendered correctly. Any time you save a file, the preview automatically updates.
Commit the changes to the branch.
bashgit add . git commit -m 'Useful commit message.'Push the branch to GitHub.
bashgit push origin <your-feature-branch>Open a pull request from the new branch to the original repo.
What files do I edit?
You can edit most .mdx files in the repo directly. Content in a few directories is generated from upstream code. Edit the code in the source repo, not in wandb/docs. After your upstream change is merged and released, when the relevant content is next generated, your change will be included.
| Directory | Source repo |
|---|---|
/ref/python/ |
wandb/wandb |
/models/ref/cli/ |
wandb/wandb |
/weave/api-reference/ |
wandb/weave |
/weave/cookbooks/ |
wandb/weave |
/weave/reference/ |
wandb/weave |
AI resources
The AGENTS.md file contains guidance and style conventions specifically designed for AI agents working with this repository. This includes:
- Project context and your role as a W&B docs team member
- Core principles for writing clear, accurate documentation
- Comprehensive style guide with examples
- Code formatting standards and best practices
- Collaboration guidelines
For complex, multi-step procedures, see the runbooks/ directory which contains step-by-step instructions for tasks like testing GitHub Actions changes.
If you're using an AI agent to help with documentation tasks, provide AGENTS.md as context to ensure consistent, high-quality contributions.
License
The source for this documentation is offered under the Apache 2.0 license.
Notices
Attributions
- This project uses Mintlify. License
- A dependency of Docsy is the
caniuse-litepackage, offered under CC-BY-4.0. License - Another dependency of Docsy is Font Awesome Free, offered under the CC-BY-4.0, SIL OFL 1.1, and MIT licenses. License notice
- This site is built using Hugo, a static site generator. License