From 2e6819c69da2f1709e8a11cf36ce5cf7c35efc80 Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Sat, 23 May 2026 02:28:47 +0000 Subject: [PATCH] docs: document assistant content updates workflow and changelog context repos --- workflows/enable.mdx | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/workflows/enable.mdx b/workflows/enable.mdx index a465adc8c..392be6d78 100644 --- a/workflows/enable.mdx +++ b/workflows/enable.mdx @@ -38,6 +38,14 @@ For workflows that run on push events, specify the repositories to watch. You ca For GitHub repositories, you must install the Mintlify GitHub App on each repository. Add repositories on the [GitHub app](https://dashboard.mintlify.com/settings/organization/github-app) settings page. +### Context repositories + +Some workflows let you add context repositories so the agent can read source code, release notes, or other references when it runs. You can add up to five context repositories per workflow. + +Context repositories are available for workflows where the agent needs information outside your content repository, like the **Changelog** workflow. They are read-only — the agent cannot push changes to a context repository. + +For GitHub repositories, you must install the Mintlify GitHub App on each context repository. For GitLab repositories, connect each project through the GitLab OAuth integration. + ### Update mode Each workflow has a default mode for how it makes updates, either by directly updating your content repository or by opening a pull request. @@ -74,14 +82,20 @@ You can change the target languages at any time by opening the workflow's settin After saving the workflow, click **Translate now** to run it on demand using the currently saved target languages. The workflow must be enabled to trigger a manual run. Manual runs do not affect the workflow's regular trigger. -## Improve docs from assistant chats +## Assistant content updates -The **Improve docs from assistant chats** workflow reviews recent trends in [assistant](/assistant/index) questions and opens targeted documentation updates that address gaps your users hit. +The **Assistant content updates** workflow reviews recent trends in [assistant](/assistant/index) questions and opens targeted documentation updates that address gaps your users hit. Use this workflow when you want the agent to triage assistant activity for you and propose changes that answer the questions users actually ask. This workflow runs on a schedule. It does not require trigger repositories or extra context configuration. Enable it from the [Workflows](https://dashboard.mintlify.com/products/workflows?tab=workflows) page and pick whether updates merge automatically or open a pull request for review. +## Changelog + +The **Changelog** workflow drafts entries that summarize recent product changes so you can keep your changelog up to date without writing each entry by hand. + +You can run this workflow on a schedule or in response to pushes to a product repository. Add up to five [context repositories](#context-repositories) so the agent can read the source code, release notes, or merged pull requests it should summarize. + ## Improve docs from feedback The **Improve docs from feedback** workflow reviews recent [page feedback](/optimize/feedback) and opens targeted documentation updates based on the issues users report.