Skip to content

fix(docs): repair broken links from v6 SDK migration#436

Closed
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/1bf11df0
Closed

fix(docs): repair broken links from v6 SDK migration#436
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/1bf11df0

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Summary

Fix all broken links surfaced by mint validate and mint broken-links after the v6 SDK docs restructure.

Changes

  • docs.json — remove the Build nav group; it referenced v6/build/environments and v6/build/tasks, neither of which exist in the repo. Their content is already covered by v6/reference/environment and v6/reference/tasks.
  • v6/advanced/subagents.mdx — repoint /v6/build/environments#lifecycle-hooks/v6/reference/environment#lifecycle-hooks (section exists there).
  • v6/reference/capabilities.mdx — repoint the Environments card from /v6/build/environments/v6/reference/environment.
  • v5/reference/cli/eval.mdx/v5/reference/tasks/v5/building/tasks-and-evaluation.
  • v5/reference/cli/init.mdx/build-environments/v5/building/scaffolding; /build-environments/spec/v5/reference/environments.
  • v5/reference/cli/push.mdx/build-environments/v5/building/scaffolding.

Context

The v6 merge (#421) added a Build nav group pointing to pages that were never authored, and left several legacy v5 CLI pages linking to pre-v5 paths. mint validate and mint broken-links now both pass.


Note

Low Risk
Documentation-only link and navigation fixes with no runtime or API changes.

Overview
Repairs documentation navigation and cross-links after the v6 SDK docs restructure so Mintlify validation (mint validate, mint broken-links) passes again.

v6 nav: Removes the Build group from docs.json because it pointed at missing pages (v6/build/environments, v6/build/tasks); that material lives under Reference instead.

v6 content links: Updates subagents and capabilities to use /v6/reference/environment (including #lifecycle-hooks) instead of the removed /v6/build/environments paths.

v5 CLI “See also”: Retargets legacy paths on eval, init, and push to the current v5 locations (/v5/building/tasks-and-evaluation, /v5/building/scaffolding, /v5/reference/environments).

Reviewed by Cursor Bugbot for commit 6b768b5. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify mintlify Bot mentioned this pull request Jun 19, 2026
@mintlify

mintlify Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
hud 🟢 Ready View Preview Jun 19, 2026, 10:10 PM

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