Skip to content

docs: explain which links mint broken-links checks - #8075

Closed
mintlify[bot] wants to merge 4 commits into
mainfrom
autopilot/4a14955e
Closed

mintlify[bot] wants to merge 4 commits into
mainfrom
autopilot/4a14955e

Conversation

@mintlify

@mintlify mintlify Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Documents which links mint broken-links checks and how it resolves paths without a leading slash.

The command now also checks reference-style links, and href/src values written as a fixed value in braces (such as href={"/quickstart"}). A path like quickstart or ../quickstart now resolves from the page's directory, the way a browser does, instead of from the site root. Because of that, some links that passed before may now report as broken.

Based on a merged CLI change that widens link extraction and fixes relative path resolution in the broken-links check.

This PR carries the agent skill edits for this change: the mint broken-links bullet in the skill's CLI reference keeps the wording already on main and adds which elements are checked and to start with / to link from the site root.

This edits only the mint broken-links section, so it does not overlap the mint validate changes in #8068.

Duplicate check: searched open docs PRs for "broken links", "link" and "relative", plus open and recent PRs by mintlify[bot], sophiabarness and ethanpalm.

@mintlify

mintlify Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated
Mintlify Docs 🟢 Ready View Preview Oct 27, 2026, 3:58 AM

@ethanpalm

Copy link
Copy Markdown
Collaborator

@sophiabarness, do you know the original intent of this PR? It got kind of garbled. I can revert to the first commit if that looks like what it's meant to add

@mintlify

mintlify Bot commented Oct 31, 2026

Copy link
Copy Markdown
Contributor Author

@ethanpalm Yes, the intent was only the first commit (the mint broken-links section of cli/commands.mdx plus the matching skill bullet), and a later merge of main got flattened into this branch, so I reopened that change cleanly as #8219 and am closing this one.

@mintlify mintlify Bot closed this Oct 31, 2026
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.

2 participants