Document maintenance follow-up on workflow PRs

workflows/index.mdx

@@ -19,10 +19,26 @@
 
 Workflows support two trigger types.
 
 - **Schedule (cron)** — Run on a recurring daily, weekly, or monthly schedule. Workflows queue within 10 minutes of the scheduled time.
 - **Push events** — Run when changes push to a specific repository or branch, including pull request merges and direct pushes.
 
-You cannot combine trigger types in a single workflow. Each workflow has exactly one trigger. 
+You cannot combine trigger types in a single workflow. Each workflow has exactly one trigger.
+
+## Maintenance follow-up
+
+Some workflow templates apply documentation best practices across your project. These run as a follow-up pass on pull requests opened by other workflows so that maintenance checks aren't skipped on bot-authored PRs.
+
+Maintenance workflow templates include:
+
+- **Translations** — Mirror prose changes into other configured languages.
+- **Writing style** — Enforce consistent voice, tone, and formatting.
+- **Typo check** — Catch spelling, grammar, and broken markdown.
+- **Broken link detection** — Find and fix links that don't resolve.
+- **SEO metadata audit** — Check titles and descriptions for length and uniqueness.
+
+When another workflow (for example, a changelog or feature docs workflow) opens a pull request, the agent applies every enabled maintenance workflow inline and pushes the fixes as additional commits to the same branch. The pull request is finalized — and [automerge](/workflows/enable#update-mode) runs, if enabled — only after the maintenance pass completes.
+
+To enable a maintenance pass, turn on the corresponding template from the [Workflows](https://dashboard.mintlify.com/products/workflows?tab=workflows) page. Maintenance workflows still run on their own trigger as usual; the follow-up behavior is additive.
 
 ## Usage limits