Skip to content

Revisions #274

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
albertov19 merged 6 commits into from
Apr 9, 2026
Merged

Revisions #274

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
8807452
Add Enterprise plan note to PR Reviews pages and snippet
albertov19 Apr 9, 2026
a320488
Fix admonition order on PR Reviews quickstart to match platform pages
albertov19 Apr 9, 2026
bf8a6da
Fix admin consent note to require Project Collection Administrator
albertov19 Apr 9, 2026
d77e59f
Fix link text in admin consent note to match anchor
albertov19 Apr 9, 2026
741c2dd
Align intro paragraph with Project Collection Administrators requirement
albertov19 Apr 9, 2026
78b5fee
Consolidate Azure DevOps admonitions to reduce visual noise
albertov19 Apr 9, 2026
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
2 changes: 1 addition & 1 deletion .snippets/text/code-reviews/pr-reviews-enterprise.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
!!! note "Enterprise plan"
PR Reviews is available exclusively on the Enterprise plan. To enable PR Reviews for your organization, contact the kluster.ai team at [sales@kluster.ai](mailto:sales@kluster.ai){target=\_blank}.
PR Reviews is available exclusively on the Enterprise plan. To enable PR Reviews for your organization, contact the kluster.ai team at [sales@kluster.ai](mailto:sales@kluster.ai){target=\_blank}.
12 changes: 3 additions & 9 deletions code-reviews/pr-reviews/azure-devops.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,36 +8,30 @@ categories: PR Reviews

Connect the [kluster.ai](https://www.kluster.ai/){target=\_blank} Code Review solution to your Azure DevOps repositories to automatically review every pull request. The setup uses a token-based integration that requires a personal access token and your organization URL before the bot can begin reviewing your pull requests.

Before connecting, an administrator in your Azure DevOps organization must complete a one-time consent step directly from the kluster.ai platform. After that, any team member with the right permissions can generate a token and finish the setup.
Before connecting, an administrator in your Azure DevOps organization must complete a one-time consent step directly from the kluster.ai platform. After that, any member of **Project Collection Administrators** can generate a token and finish the setup.

Once connected, the bot reviews every new pull request and every new commit pushed to an open pull request. No additional configuration is needed.

--8<-- 'text/code-reviews/pr-reviews-enterprise.md'

--8<-- 'text/code-reviews/pr-reviews-tip.md'

!!! warning "Custom rules not supported"
[Custom rules](/code-reviews/configuration/rules/) — including learned rules extracted from repositories — are not currently supported for Azure DevOps. Reviews use the default kluster analysis without project-specific rule customization.

## Prerequisites

Before getting started, ensure you have:

- A [kluster.ai](https://platform.kluster.ai/signup){target=\_blank} account.
- An Azure DevOps account that is a member of **Project Collection Administrators** in your organization.
- An Azure DevOps account that is a member of **Project Collection Administrators** in your organization. This role is required to install webhooks. If the account has insufficient permissions, webhook installation will fail silently and pull request reviews will not appear. To fix this, navigate to **Organization Settings** > **Security** > **Permissions**, find the user, and add them to **Project Collection Administrators**. After updating permissions, click **Re-install** on the PR Reviews page in the kluster.ai platform.
- A personal access token with the required scopes. See [Create a personal access token](#create-a-personal-access-token) for instructions.

!!! warning "Verify account permissions"
The account that generates the personal access token must be a member of **Project Collection Administrators**. Having the correct token scopes is not enough — the account itself needs this role to install webhooks. If the account has insufficient permissions, webhook installation will fail silently and pull request reviews will not appear. To fix this, navigate to **Organization Settings** > **Security** > **Permissions**, find the user, and add them to **Project Collection Administrators**. After updating permissions, click **Re-install** on the PR Reviews page in the kluster.ai platform to complete the setup.

## Admin consent

Before anyone in your organization can connect kluster to Azure DevOps, an administrator or organization owner must grant consent. This is a one-time step per organization that applies to both PR reviews and repo reviews.

The admin consent step appears as step 1 when you begin the Azure DevOps connection flow on the kluster.ai platform (see [Connect Azure DevOps](#connect-azure-devops)). If you are the organization admin, click **Open** to review and accept the required permissions. If you are not, click **Copy link** and share it with your organization admin to complete the consent.

!!! note
Admin consent only needs to be completed once. After the admin accepts, all team members in the organization can connect their projects without repeating this step.
Admin consent only needs to be completed once. After the admin accepts, any member of **Project Collection Administrators** in the organization can connect projects without repeating the consent step. See [Prerequisites](#prerequisites) for the required role. Note that [custom rules](/code-reviews/configuration/rules/) — including learned rules — are not currently supported for Azure DevOps.

## Create a personal access token

Expand Down
Loading