Skip to content

Confirm scheduled broken-link-detection automation - #211

Merged
digitaldiina merged 2 commits into
mainfrom
81-scheduled-broken-links
Aug 11, 2026
Merged

Confirm scheduled broken-link-detection automation#211
digitaldiina merged 2 commits into
mainfrom
81-scheduled-broken-links

Conversation

@digitaldiina

Copy link
Copy Markdown
Contributor

Closes #81.

Stacked on #207 (not yet merged) - this branch was cut from 137-ci-workflows since contribute/automated-tests.mdx (added there) is where this issue's findings live. The diff below will narrow to just this PR's own commit once #207 merges.

Investigated the issue's own "native alternative" question

#81 explicitly asks to check whether Mintlify offers a native broken-link monitoring feature before building a custom scheduled job. It does: mint automations create --type broken-link-detection --cron "<expr>" - a hosted automation that periodically re-scans the whole site and can auto-fix broken links (rename/move detection, or copy edits when a target was removed) by opening a PR.

What was created

mint automations create --name "Broken link detection" --type broken-link-detection --cron "0 6 1,15 * *" --format json
  • Cadence: biweekly, approximated as the 1st and 15th of each month (standard cron has no native "every 2 weeks" field - see contribute/automated-tests.mdx for the reasoning).
  • Auto-merge: off - any fix PR it opens goes through the same manual review as everything else in this repo.
  • Created now, not at launch: unused Mintlify credits do not fully roll over past the monthly reset, so running it now rather than waiting doesn't waste anything.
  • Fallback kept: tools/triage-broken-links.py + mint broken-links CLI stay documented as the manual/second-opinion method, given a Mintlify community report of the hosted check under-reporting in some cases (HTTP 200 served for an actual 404).

What shipped

contribute/automated-tests.mdx's "Scheduled check" section, filled in with the confirmed mint automations list output (status: active, nextRunAt: 2026-08-15T06:00:00.000Z).

Verification

  • mint automations create output and a follow-up mint automations list both confirmed status: active, correct cron/type, no automerge field.
  • markdownlint-cli2 contribute/automated-tests.mdx: 0 issues.

@mintlify

mintlify Bot commented Aug 11, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
superofficeas 🟢 Ready View Preview Aug 11, 2026, 6:18 AM

mint automations create --type broken-link-detection --cron
"0 6 1,15 * *" is now active (created 2026-08-11, first run
2026-08-15), no automerge. Fills in the placeholder left in
contribute/automated-tests.mdx by #137's PR with the confirmed
mint automations list output.
@digitaldiina
digitaldiina force-pushed the 81-scheduled-broken-links branch from 8a45859 to 3f5a963 Compare August 11, 2026 06:44
Prose dates use "Month D, YYYY" elsewhere in this repo, not ISO -
fixed. Also cut the "created now vs. waiting for launch" credit
rationale - PR history already covers that reasoning, doesn't need
to live in the durable reference page too.
@digitaldiina
digitaldiina merged commit c8a6e4b into main Aug 11, 2026
4 checks passed
@digitaldiina
digitaldiina deleted the 81-scheduled-broken-links branch August 11, 2026 06:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

mintlify/ci Build/deploy pipeline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Automated broken-link checking (scheduled, repo-wide)

1 participant