Skip to content
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions workflows/enable.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,22 @@

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.

Check warning on line 43 in workflows/enable.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

workflows/enable.mdx#L43

In general, use active voice instead of passive voice ('are cloned').

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.
Expand Down Expand Up @@ -72,6 +88,6 @@

#### Run a translation immediately

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.

Check warning on line 91 in workflows/enable.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

workflows/enable.mdx#L91

In general, use active voice instead of passive voice ('be enabled').

<GitlabWorkflowSetup />
Loading