Skip to content

Add Azure Repos deployment guide - #7720

Merged
ethanpalm merged 7 commits into
mainfrom
nivedh/azure-repos-docs
Oct 30, 2026
Merged

ethanpalm merged 7 commits into
mainfrom
nivedh/azure-repos-docs

Conversation

@N43527

@N43527 N43527 commented Oct 5, 2026 •

Copy link
Copy Markdown
Contributor

ENG-11564. Do not merge yet. Ethan is handling the merge timing.

Adds a deploy/azure-repos page next to Bitbucket. It covers:

  • Connecting through Microsoft Entra ID: admin consent, adding the Mintlify app to the organization and project, and the Project Administrators requirement for service hooks
  • The setup wizard and switching an existing deployment to Azure Repos
  • Changing the organization's Microsoft connection
  • Web editor sync and publishing
  • PR preview deployments
  • Troubleshooting for each connect error the server returns
  • Autopilot and the Slack agent on Azure Repos
  • Limitations: no Azure DevOps Server; Autopilot doesn't assign, request reviews, or respond to comments on Azure Repos pull requests; service hooks aren't removed when you switch providers

Updated Oct 25 to match server main:

  • Preview deployments are documented. They shipped in mintlify/server#9432.
  • The connecting Microsoft account must be a project administrator or have Manage permissions on the repository (mintlify/server#9416).
  • The callout now says Azure Repos requires an Enterprise plan.
  • Azure Repos is added to the Vale vocabulary.

Updated Oct 29:

  • Merged main.
  • Documented Autopilot on Azure Repos (mintlify/server#9904, mintlify/mint#13641) on this page and in autopilot.mdx.

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only changes with no application code or security-sensitive logic.

Overview
Adds a new Azure Repos deployment guide under Deployments and links it from docs.json.

The page documents connecting via Microsoft Entra ID (Enterprise plan), the Git Settings wizard, switching providers, web editor sync, PR preview deployments, Slack agent behavior, troubleshooting, and known limits (no Azure DevOps Server; service hooks stay if you switch away).

Autopilot docs now treat Azure Repos as a supported Git provider: prerequisites, an Azure Repos repositories integrations section, and notes that Autopilot does not assign or request reviews on Azure PRs, does not reply to PR comments (same as GitLab), and merge conflicts should be resolved in your Git provider rather than only on GitHub.

Reviewed by Cursor Bugbot for commit 2f54e65. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Oct 5, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Mintlify Docs 🟢 Ready View Preview Oct 30, 2026, 10:28 PM

…Enterprise gating

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
ethanpalm and others added 2 commits October 29, 2026 19:29
Autopilot supports Azure Repos as of mintlify/server#9904. Add Azure
Repos to the Autopilot prerequisites and integrations, note that it
can't assign, request reviews, or respond to comments on Azure Repos
pull requests, and add an Autopilot section to the Azure Repos page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@ethanpalm ethanpalm left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm! just a few small nits

Comment thread deploy/azure-repos.mdx Resolved
Comment thread deploy/azure-repos.mdx
---

<Info>
Azure Repos requires an [Enterprise plan](https://mintlify.com/pricing?ref=azure-repos).

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For posterity, this is proper punctuation when referring to Azure Repos

Comment thread deploy/azure-repos.mdx Resolved
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
@ethanpalm
ethanpalm merged commit b2f2cc1 into main Oct 30, 2026
6 checks passed
@ethanpalm
ethanpalm deleted the nivedh/azure-repos-docs branch October 30, 2026 22:33

This branch was successfully deployed

1 active deployment
staging — 2f54e659 Deployed Oct 30, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants