From 3f5a963d87e1001a1039b393eca2089ad82d4ddd Mon Sep 17 00:00:00 2001 From: Bergfrid Dias Date: Tue, 11 Aug 2026 08:44:09 +0200 Subject: [PATCH 1/2] Confirm scheduled broken-link-detection automation (#81) 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. --- contribute/automated-tests.mdx | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/contribute/automated-tests.mdx b/contribute/automated-tests.mdx index 21b6425862..0bb38e1943 100644 --- a/contribute/automated-tests.mdx +++ b/contribute/automated-tests.mdx @@ -44,13 +44,21 @@ A Mintlify community report (October 2025) describes a case where a page serving A per-PR link check only catches breaks introduced by that PR. A separate, Mintlify-hosted automation periodically re-scans the *entire* site, catching drift from any source - including direct admin-bypass pushes that skip PR review entirely. -* **Type:** `broken-link-detection` (`mint automations create --type broken-link-detection`) +**Active** since 2026-08-11, first run 2026-08-15 (`nextRunAt` confirmed via `mint automations list`). + +* **Type:** `broken-link-detection` * **Cadence:** `0 6 1,15 * *` - the 1st and 15th of each month, run at 06:00. Standard cron has no native "every 2 weeks" field; this is the closest non-drifting approximation of a biweekly cadence (actual gaps land at 13-16 days depending on the month). * **Auto-merge:** off. When the automation finds and fixes a broken link, it opens a PR like any other change - it goes through the same manual review as everything else in this repo, it does not merge itself. * **What it does:** for each broken internal link, it checks whether the target page was renamed or moved and updates the link, or - if the target was removed entirely - edits the surrounding copy to remove or replace the reference. -* **Cost:** billed in Mintlify credits per run (rough public estimate: ~285 credits/run) - a real operating cost, not a free background job. +* **Cost:** billed in Mintlify credits per run (rough public estimate: ~285 credits/run) - a real operating cost, not a free background job. Created now rather than waiting for launch since unused credits do not fully roll over past the monthly reset. + +Setup record (issue [#81][4]): + +```sh +mint automations create --name "Broken link detection" --type broken-link-detection --cron "0 6 1,15 * *" --format json +``` -See [issue #81][4] for the setup record (creation command, confirmed `mint automations list` output). +`mint automations list` confirms it registered with `status: active`, no `automerge` field (off by default), and the cron/type above. ## Fallback: manual broken-link check From 427d0bc35c360e3b2b863882402dc05f8009f943 Mon Sep 17 00:00:00 2001 From: Bergfrid Dias Date: Tue, 11 Aug 2026 08:48:45 +0200 Subject: [PATCH 2/2] Fix prose date format, drop redundant credit-timing note 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. --- contribute/automated-tests.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contribute/automated-tests.mdx b/contribute/automated-tests.mdx index 0bb38e1943..efef11a2f1 100644 --- a/contribute/automated-tests.mdx +++ b/contribute/automated-tests.mdx @@ -44,13 +44,13 @@ A Mintlify community report (October 2025) describes a case where a page serving A per-PR link check only catches breaks introduced by that PR. A separate, Mintlify-hosted automation periodically re-scans the *entire* site, catching drift from any source - including direct admin-bypass pushes that skip PR review entirely. -**Active** since 2026-08-11, first run 2026-08-15 (`nextRunAt` confirmed via `mint automations list`). +**Active** since August 11, 2026, first run August 15, 2026 (`nextRunAt` confirmed via `mint automations list`). * **Type:** `broken-link-detection` * **Cadence:** `0 6 1,15 * *` - the 1st and 15th of each month, run at 06:00. Standard cron has no native "every 2 weeks" field; this is the closest non-drifting approximation of a biweekly cadence (actual gaps land at 13-16 days depending on the month). * **Auto-merge:** off. When the automation finds and fixes a broken link, it opens a PR like any other change - it goes through the same manual review as everything else in this repo, it does not merge itself. * **What it does:** for each broken internal link, it checks whether the target page was renamed or moved and updates the link, or - if the target was removed entirely - edits the surrounding copy to remove or replace the reference. -* **Cost:** billed in Mintlify credits per run (rough public estimate: ~285 credits/run) - a real operating cost, not a free background job. Created now rather than waiting for launch since unused credits do not fully roll over past the monthly reset. +* **Cost:** billed in Mintlify credits per run (rough public estimate: ~285 credits/run) - a real operating cost, not a free background job. Setup record (issue [#81][4]):