Skip to content

Fix broken links - #317

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/43dd70e4
Open

Fix broken links#317
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/43dd70e4

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

Summary

mint broken-links and mint validate passed, but a deeper anchor audit found ~70 links pointing at anchors that no longer exist (mostly GitBook-style #id-N.-… anchors left over from migration, plus renamed headings and dead footnote refs). All are fixed and re-validated.

Changes

  • GitBook-style #id-N.-… anchors rewritten to Mintlify slugs (e.g. #id-2.-customize-your-transformation#2-customize-your-transformation) in flaky-tests/webhooks/*, flaky-tests/recipes/alert-on-test-escalation.mdx, and flaky-tests/reference/cli-reference.mdx.
  • 26 framework pages: otherci#id-1.-store-a-trunk_token-secret-in-your-ci-systemotherci#trunk-organization-slug-and-token (old heading no longer exists).
  • Renamed/removed headings retargeted:
    • detection#stable-branchesdetection#branch-aware-detection (Bamboo, Cloud Build)
    • failure-rate-monitor#branch-pattern-syntax#branch-scope (pattern syntax lives under Branch Scope)
    • linear-integration#api-token-permissions#api-key-permissions
    • managing-your-organization#slug#organization-slug-and-token
    • billing#free-plans-and-trials#free-plan
    • quarantining#whats-affected#what-does-quarantined-mean; #using-the-trunk-cli-directly#updates-in-ci
    • get-started#id-4.-confirm-your-configuration…#step-3-verify-integration
    • github-integration#uploading-results / #what-is-a-.trunk-repository#what-is-a-trunk-repository
    • webhooks#testcaseinvestigationcompleted#test_case-investigation_completed
    • merge-queue/getting-started#submit-pull-requests/merge-queue/using-the-queue/reference#submitting-and-cancelling-pull-requests
    • lint config: #commands#run, #how-code-qualit-runs-linters#how-code-quality-runs-linters, output-parsing#node/#python../runtimes, run-linters#sample#recipes, ansible-lint ../#trigger-rules../configure-linters#trigger-rules
  • API anchors now point at the generated endpoint pages: merge#post-getmergequeuetestingdetailsmerge/get-details-about-testing-that-merge-queue-is-performing, merge#post-submitpullrequestmerge/submit-a-pull-request-to-a-merge-queue, api-reference#post-flaky-tests-link-ticket-to-test-caseapi-reference/link-a-ticket-to-a-test-case.
  • Dead footnote refs in billing.mdx (#user-content-fn-1, footnote never rendered) inlined as plain text; orphan footnote definition removed.
  • parallel-queues pages: dead merge-queue#single-mode-vs.-parallel-mode anchor → /merge-queue/optimizations/parallel-queues.
  • advanced-settings.mdx: dropped dead #custom-merge-commit-titles anchor (section only exists on the linking page itself); link now targets the Submit and cancel pull requests page.

Context

Anchor slugs were verified against the rendered site (Mintlify converts . and other punctuation to -, keeps underscores). mint validate and mint broken-links both pass.

@mintlify

mintlify Bot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
trunk 🟢 Ready View Preview Aug 26, 2026, 10:27 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

0 participants