Skip to content

docs(changelog): root-relative, deep-linked doc links for the recent batch#159

Merged
samgutentag merged 2 commits into
mainfrom
sam-gutentag/changelog-link-cleanup
May 29, 2026
Merged

docs(changelog): root-relative, deep-linked doc links for the recent batch#159
samgutentag merged 2 commits into
mainfrom
sam-gutentag/changelog-link-cleanup

Conversation

@samgutentag
Copy link
Copy Markdown
Member

Follow-up cleanup on the 10 changelog entries published in the recent backlog sweep. Two fixes per entry where applicable:

  1. Root-relative links — convert https://docs.trunk.io/... to /... (per Mintlify guidance; tracked broadly in TRUNK-18408).
  2. Deep links to specific headings instead of page tops — "more direct the better."
Entry Was Now
run-history-filters …/managing-detected-flaky-tests (top) /flaky-tests/dashboard#filters
repositories-overview …/dashboard (top) /flaky-tests/dashboard#repositories-overview
detect-broken …/failure-rate-monitor (top) …/failure-rate-monitor#action
pass-on-retry-branch-scope …/pass-on-retry-monitor (top) …/pass-on-retry-monitor#branch-scope
mq-failure-statuses …/merge/get-details-about-testing… (broken path) /merge-queue/reference/merge#post-getmergequeuetestingdetails
ai-investigations-webhooks …/webhooks (top) …/webhooks#testcaseinvestigationcompleted
flag-as-flaky …/flag-as-flaky (top) …/flag-as-flaky#flagging-a-test
linked-tickets …/ticketing (absolute) /flaky-tests/management/ticketing (no section fits)
no-monitors/jira-fields …/ticketing/jira-integration (top) …/jira-integration#custom-fields
monitor-action-types …/failure-rate-monitor#action (absolute) …/failure-rate-monitor#action (relative)

Mintlify link-rot validation on this PR confirms the anchors resolve.

🤖 Generated with Claude Code

…nked

Convert the 10 recently-published changelog entries to root-relative
doc links (per Mintlify guidance) and point each at the most specific
heading instead of the page top. Also fixes a broken target on the MQ
failure-statuses entry (the get-details... path did not exist; now
points at /merge-queue/reference/merge#post-getmergequeuetestingdetails).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 29, 2026

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

Project Status Preview Updated (UTC)
trunk 🟢 Ready View Preview May 29, 2026, 6:44 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Extend the link cleanup to previously-published entries: de-absolute all
docs.trunk.io links, fix two broken paths (infrastructure-failure-protection
was missing /detection/; threshold-monitor -> failure-rate-monitor#preview-panel),
and deep-link linear-improvements to #field-defaults.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@samgutentag samgutentag merged commit a1dbc21 into main May 29, 2026
3 checks passed
@samgutentag samgutentag deleted the sam-gutentag/changelog-link-cleanup branch May 29, 2026 06:51
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.

1 participant