From 823a0f6469d9fc0f7c78f30cd0fc7ab553019593 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sun, 17 May 2026 19:41:29 +0000 Subject: [PATCH 1/2] docs: document context repositories for workflows --- workflows/enable.mdx | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/workflows/enable.mdx b/workflows/enable.mdx index 3fe0eb7f5..cfc88d6e2 100644 --- a/workflows/enable.mdx +++ b/workflows/enable.mdx @@ -38,6 +38,22 @@ 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 + +Context repositories are cloned into the workflow's run environment as read-only references so the agent can read their code while it runs. They do not trigger the workflow. + +Use context repositories when the agent needs to read source code, configuration, or other files that live outside your docs repository. For example, point a changelog workflow at your product's backend repository so the agent can summarize recent changes, or give a custom workflow access to an SDK repository so it can keep code examples accurate. + +Context repositories are available on: + +- Custom workflows +- Changelog workflows (content update, code change, and scheduled variants) +- Other non-maintenance workflows that run on a schedule + +Maintenance workflows (translations, link checks, typo checks, and style checks) operate only on your docs and do not support context repositories. + +To configure them, open the workflow's settings and select repositories from the **Context repositories** picker. The same GitHub App installation or GitLab connection requirements apply as for trigger repositories. + ### 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. From 4bbd58cc16e9f6ecb2c59b14778ce9d6134aab94 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sun, 17 May 2026 19:44:07 +0000 Subject: [PATCH 2/2] docs: tighten context repositories example sentence --- workflows/enable.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/workflows/enable.mdx b/workflows/enable.mdx index cfc88d6e2..0eb7ba115 100644 --- a/workflows/enable.mdx +++ b/workflows/enable.mdx @@ -42,7 +42,7 @@ For GitHub repositories, you must install the Mintlify GitHub App on each reposi Context repositories are cloned into the workflow's run environment as read-only references so the agent can read their code while it runs. They do not trigger the workflow. -Use context repositories when the agent needs to read source code, configuration, or other files that live outside your docs repository. For example, point a changelog workflow at your product's backend repository so the agent can summarize recent changes, or give a custom workflow access to an SDK repository so it can keep code examples accurate. +Use context repositories when the agent needs to read source code, configuration, or other files that live outside your docs repository. For example, point a changelog workflow at your product's backend repository so the agent can summarize recent changes. Or give a custom workflow access to an SDK repository so it can keep code examples accurate. Context repositories are available on: