Mintlify test import #1709

mdlinville · 2025-10-14T22:38:56Z

Description

Scripted import of content in wandb/mintlifytest to a new branch in wandb/docs

This approach preserves the Git history of each existing file by creating many many commits:

The script operates locally in ~/docs and ~/mintlifytest repos
The script takes a hash in the mintlifytest repo as one parameter, and a branch name to create in the docs clone.
After creating the requested branch, the script:
1. Deletes Hugo files that don't have a replacement in Mintlify.
2. File by file, replaces Hugo files with the Mintlify files at the new locations. I've been asked to do it file by file to preserve the commit history of each file. I'm hoping this looks like a series of file renames.
3. Adds new Mintlify files with no equivalent Hugo files.
4. Replaces Hugo configuration files with Mintlify configuration files.
5. Updates Mintlify metadata in the filesystem to match the existing Hugo metadata, like the site name and site URL.

After checkout out the branch, you can deploy the site using npx install (one time) and npx mintlify dev. hugo commands no longer work.

To go live on Mintlify, we would:

Sign in to Cloudflare Console and remove the production and PR deploys. The Cloudflare checks disappear from all existing PRs and pushing to main no longer triggers a Cloudflare deploy.
Sign into Mintlify Console and adjust the repo and branch in https://dashboard.mintlify.com/wb-21fd5541/wb-21fd5541/settings/deployment/git-settings to point at wandb/docs and the branch where the import is. To check, I just set it to wandb/docs at the mintlify-import branch. Also adjust the site title at the same time. The Mintlify PR checks start running.
Just before merging the import branch, sign back into the Mintlify Console and change the deploy branch to main.
Merge the import branch to main. (do not squash and merge). The cut-over is complete.
Remove or archive the mintlifytest repo in Github.

Notes:
- The Files Changed and Commits tabs will probably not load in the Git UI. Check out the branch locally to review it.
- DO NOT MERGE. For this test PR, we are importing the Mintlify content as of the tip of wandb/mintlifytest#42, which is not yet fully approved and is not yet merged.
- When we do merge an equivalent PR, we should not squash and merge. Otherwise, the commit history of each file will be compressed into a single commit, defeating the purpose.
- In this PR, it is expected to that the Cloudflare checks fail.
- While the Mintlify Console is configured to look at this branch in wandb/docs, merging changes in mintlifytest will not trigger a Mintlify deploy. We should switch it back if we want to continue more iteration in that repo.

Testing

Locally, imported content looks right, builds, serves, and introduces no broken links
PR tests succeed

socket-security · 2025-10-14T22:39:14Z

All alerts resolved. Learn more about Socket for GitHub.

This PR previously contained dependency changes with security issues that have been resolved, removed, or ignored.

View full report

cloudflare-workers-and-pages · 2025-10-14T22:55:10Z

Deploying weave-redirect with Cloudflare Pages

Latest commit:	`320f34c`
Status:	🚫 Build failed.

View logs

cloudflare-workers-and-pages · 2025-10-14T22:55:11Z

Deploying docs with Cloudflare Pages

Latest commit:	`cd246a6`
Status:	🚫 Build failed.

View logs

…md to ko/models/artifacts/delete-artifacts.mdx

…dels/core/registry/model_registry_eol.mdx

…aliases.mdx

…/core/registry/registry_cards.mdx

…/core/registry/registry_types.mdx

…egistry/lineage.mdx

…dels/core/registry/organize-with-tags.mdx

…/models/core/registry/download_use_artifact.mdx

…egistry/delete_registry.mdx

…s/core/registry/create_registry.mdx

…els/core/registry/create_collection.mdx

…s/core/registry/search_registry.mdx

…dels/core/registry/configure_registry.mdx

…ore/registry/link_version.mdx

…d to ko/models/core/registry/model_registry/notifications.mdx

…rds.md to ko/models/core/registry/model_registry/create-model-cards.mdx

## Description In Mintlify, RSS feeds are available only from an individual changelog file that has `<Update>` components. Since major-version-specific RSS feeds don't make sense: - Consolidate all supported releases into release-notes/server-releases.mdx - Consolidate all unsupported releass into release-notes/server-releases-archived.mdx - Minor content adjustments - Remove card from /ref.mdx landing page - Adjust /release-notes.mdx landing page - Update the EOL snippet and use it - Remove the unused unsupported-version snippet - Delete some scripts that got inadvertently committed

Fixed 23 high-severity list formatting issues across 15 files: - Split inline bold text that should be on separate lines - Fixed sub-bullet indentation (2 spaces → 3 spaces for proper nesting) - Properly indented code blocks under list items - Fixed continuation text indentation Most affected files: - platform/hosting/self-managed/azure-tf.mdx - guides/launch/setup-launch-sagemaker.mdx - Various ja/ and ko/ translations These formatting issues were breaking list rendering in Mintlify and making documentation harder to read. Issues likely predate the migration.

## Description Fix some one-off issues after the migration - Fix Models quickstart location - Fix inadvertent lowercasing of Python API and Weave API refs by the vendor during the conversion - Bring in missed Weave reference generation scripts, update them to preserve the casing in the Weave repo Verified that all other added, renamed, updated, deleted files in `main` commits since 9/17 look correct, both for file location and content changes. The commit history in this PR is a bit of a mess. It's difficult to do case-sensitive Git commands on macOS, which has a case-insensitive filesystem.

…ave, Launch, Python refs (#1719) ## Description Adjust locations and TOCs in Mintlify: - Integrations - Tutorials - Weave - Launch - Also build up TOC, previously hidden in Hugo - Python refs - Also add landing pages to TOC, which were all missing - Add redirects - Fix broken links Ref: https://weightsandbiases.slack.com/archives/C081R4TDAH1/p1760722913588729 ## Tests - [x] mint dev - [x] mint broken-links - [ ] PR checks

## Description Add Models Quickstart to TOC

socket-security · 2025-10-17T21:21:04Z

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	pypi/requests@2.32.5
	pypi/lazydocs@0.4.8

View full report

## Description This PR: * Updates front-matter across the Weave docs. * Adds line numbers to most code blocks * Fixes a few typos and formatting issues --------- Co-authored-by: Matt Linville <[email protected]>

## Description Updates Weave to: * Fixes random index page (Integrations overview page) from showing up in Tracing section * Moves evaluation articles out of unnecessary sub-category * Updates some titles for header articles

mdlinville force-pushed the mintlify-import branch from 5cb3ea0 to 100c5ea Compare October 14, 2025 22:54

mintlify bot deployed to staging October 14, 2025 22:55 View deployment

mintlify bot deployed to staging October 14, 2025 23:07 View deployment

mintlify bot deployed to staging October 14, 2025 23:20 View deployment

mintlify bot deployed to staging October 14, 2025 23:27 View deployment

mintlify bot deployed to staging October 14, 2025 23:35 View deployment

mintlify bot deployed to staging October 14, 2025 23:40 View deployment

mintlify bot deployed to staging October 14, 2025 23:46 View deployment

mdlinville force-pushed the mintlify-import branch from 44f3e09 to cd246a6 Compare October 14, 2025 23:57

mintlify bot deployed to staging October 14, 2025 23:58 View deployment

mintlify bot deployed to staging October 15, 2025 15:51 View deployment

mdlinville added 16 commits October 15, 2025 09:38

Rename content/en/guides/core/artifacts/manage-data/delete-artifacts.…

d35cd57

…md to ko/models/artifacts/delete-artifacts.mdx

Rename content/en/guides/core/registry/model_registry_eol.md to ko/mo…

ba5a51d

…dels/core/registry/model_registry_eol.mdx

Rename content/en/guides/core/registry/aliases.md to models/registry/…

22a8bee

…aliases.mdx

Rename content/en/guides/core/registry/registry_cards.md to ko/models…

b2c1dcf

…/core/registry/registry_cards.mdx

Rename content/en/guides/core/registry/registry_types.md to ko/models…

a38bdf2

…/core/registry/registry_types.mdx

Rename content/en/guides/core/registry/lineage.md to ko/models/core/r…

33d7a9c

…egistry/lineage.mdx

Rename content/en/guides/core/registry/organize-with-tags.md to ko/mo…

5cf0702

…dels/core/registry/organize-with-tags.mdx

Rename content/en/guides/core/registry/download_use_artifact.md to ko…

d7288f0

…/models/core/registry/download_use_artifact.mdx

Rename content/en/guides/core/registry/delete_registry.md to models/r…

bff9508

…egistry/delete_registry.mdx

Rename content/en/guides/core/registry/create_registry.md to ko/model…

56f693d

…s/core/registry/create_registry.mdx

Rename content/en/guides/core/registry/create_collection.md to ko/mod…

cc8d16f

…els/core/registry/create_collection.mdx

Rename content/en/guides/core/registry/search_registry.md to ko/model…

1e9dc57

…s/core/registry/search_registry.mdx

Rename content/en/guides/core/registry/configure_registry.md to ko/mo…

01989e7

…dels/core/registry/configure_registry.mdx

Rename content/en/guides/core/registry/link_version.md to ko/models/c…

a074de6

…ore/registry/link_version.mdx

Rename content/en/guides/core/registry/model_registry/notifications.m…

675c7d1

…d to ko/models/core/registry/model_registry/notifications.mdx

Rename content/en/guides/core/registry/model_registry/create-model-ca…

c9e2309

…rds.md to ko/models/core/registry/model_registry/create-model-cards.mdx

mintlify bot deployed to staging October 15, 2025 21:43 View deployment

mintlify bot deployed to staging October 16, 2025 00:40 View deployment

mintlify bot deployed to staging October 17, 2025 19:07 View deployment

mintlify bot deployed to staging October 17, 2025 19:10 View deployment

johndmulhausen force-pushed the mintlify-import branch from bad5d31 to 71494d5 Compare October 17, 2025 19:27

mintlify bot deployed to staging October 17, 2025 19:28 View deployment

cool icons

3f63891

mintlify bot deployed to staging October 17, 2025 19:59 View deployment

logo fix

f7e2f09

mintlify bot deployed to staging October 17, 2025 20:03 View deployment

mintlify bot deployed to staging October 17, 2025 20:12 View deployment

nav fixes

bf2549d

mintlify bot deployed to staging October 17, 2025 20:18 View deployment

Homepage fix

ba04350

mintlify bot deployed to staging October 17, 2025 20:41 View deployment

Update default padding in HomeWrapper component from "px-12" to "0"

b225c0f

mintlify bot deployed to staging October 17, 2025 20:57 View deployment

wide landing pages

8c97c17

mintlify bot deployed to staging October 17, 2025 21:17 View deployment

Add Models Quickstart to TOC (#1720)

c7271ad

## Description Add Models Quickstart to TOC

mintlify bot deployed to staging October 17, 2025 21:20 View deployment

Mintlify Weave updates (#1717)

8abd139

## Description This PR: * Updates front-matter across the Weave docs. * Adds line numbers to most code blocks * Fixes a few typos and formatting issues --------- Co-authored-by: Matt Linville <[email protected]>

mintlify bot deployed to staging October 17, 2025 21:38 View deployment

Mintlify: Fixes for Weave IA (#1721)

91e35fd

## Description Updates Weave to: * Fixes random index page (Integrations overview page) from showing up in Tracing section * Moves evaluation articles out of unnecessary sub-category * Updates some titles for header articles

mintlify bot deployed to staging October 17, 2025 22:32 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Mintlify test import #1709

Mintlify test import #1709

Uh oh!

mdlinville commented Oct 14, 2025 •

edited

Loading

Uh oh!

socket-security bot commented Oct 14, 2025 •

edited

Loading

Uh oh!

cloudflare-workers-and-pages bot commented Oct 14, 2025 •

edited

Loading

Uh oh!

cloudflare-workers-and-pages bot commented Oct 14, 2025 •

edited

Loading

Uh oh!

socket-security bot commented Oct 17, 2025 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Mintlify test import #1709

Are you sure you want to change the base?

Mintlify test import #1709

Uh oh!

Conversation

mdlinville commented Oct 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Testing

Uh oh!

socket-security bot commented Oct 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cloudflare-workers-and-pages bot commented Oct 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying weave-redirect with Cloudflare Pages

Uh oh!

cloudflare-workers-and-pages bot commented Oct 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying docs with Cloudflare Pages

Uh oh!

socket-security bot commented Oct 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

mdlinville commented Oct 14, 2025 •

edited

Loading

socket-security bot commented Oct 14, 2025 •

edited

Loading

cloudflare-workers-and-pages bot commented Oct 14, 2025 •

edited

Loading

cloudflare-workers-and-pages bot commented Oct 14, 2025 •

edited

Loading

socket-security bot commented Oct 17, 2025 •

edited

Loading