From 88074529ff2bbf7f248374956aacb5b2c58c35c6 Mon Sep 17 00:00:00 2001 From: Alberto Viera Date: Thu, 9 Apr 2026 10:15:25 +0000 Subject: [PATCH 1/6] Add Enterprise plan note to PR Reviews pages and snippet Co-Authored-By: Claude Opus 4.6 (1M context) --- .snippets/text/code-reviews/pr-reviews-enterprise.md | 2 +- code-reviews/pr-reviews/quickstart.md | 2 ++ 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/.snippets/text/code-reviews/pr-reviews-enterprise.md b/.snippets/text/code-reviews/pr-reviews-enterprise.md index 1b89e73a..568310c6 100644 --- a/.snippets/text/code-reviews/pr-reviews-enterprise.md +++ b/.snippets/text/code-reviews/pr-reviews-enterprise.md @@ -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}. \ No newline at end of file + 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}. diff --git a/code-reviews/pr-reviews/quickstart.md b/code-reviews/pr-reviews/quickstart.md index b1fbef66..b0841d44 100644 --- a/code-reviews/pr-reviews/quickstart.md +++ b/code-reviews/pr-reviews/quickstart.md @@ -15,6 +15,8 @@ The bot acts as a last line of defense. It catches issues that were missed durin !!! tip "Best used as a safety net" PR Reviews is most effective when combined with earlier review stages. Install the [kluster.ai extension](/code-reviews/get-started/installation/) in your IDE or set up [CLI hooks](/code-reviews/cli/git-hooks/) to catch issues while you code. The PR bot then confirms nothing was missed. +--8<-- 'text/code-reviews/pr-reviews-enterprise.md' + ## How it works Once installed, the kluster.ai bot triggers automatically in two situations: From a32048897262f3c473c813677aac0086daf92da0 Mon Sep 17 00:00:00 2001 From: Alberto Viera Date: Thu, 9 Apr 2026 10:47:18 +0000 Subject: [PATCH 2/6] Fix admonition order on PR Reviews quickstart to match platform pages Enterprise note now appears before the tip, consistent with GitHub, GitLab, Bitbucket, and Azure DevOps pages. Co-Authored-By: Claude Opus 4.6 (1M context) --- code-reviews/pr-reviews/quickstart.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/code-reviews/pr-reviews/quickstart.md b/code-reviews/pr-reviews/quickstart.md index b0841d44..b1fbef66 100644 --- a/code-reviews/pr-reviews/quickstart.md +++ b/code-reviews/pr-reviews/quickstart.md @@ -15,8 +15,6 @@ The bot acts as a last line of defense. It catches issues that were missed durin !!! tip "Best used as a safety net" PR Reviews is most effective when combined with earlier review stages. Install the [kluster.ai extension](/code-reviews/get-started/installation/) in your IDE or set up [CLI hooks](/code-reviews/cli/git-hooks/) to catch issues while you code. The PR bot then confirms nothing was missed. ---8<-- 'text/code-reviews/pr-reviews-enterprise.md' - ## How it works Once installed, the kluster.ai bot triggers automatically in two situations: From bf8a6da73391921a6e36ec7e0e72dd774e4cf1e9 Mon Sep 17 00:00:00 2001 From: Alberto Viera Date: Thu, 9 Apr 2026 14:34:11 +0000 Subject: [PATCH 3/6] Fix admin consent note to require Project Collection Administrator The note previously said all team members can connect projects after admin consent, contradicting the Project Collection Administrator requirement for webhook installation. Co-Authored-By: Claude Opus 4.6 (1M context) --- code-reviews/pr-reviews/azure-devops.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/code-reviews/pr-reviews/azure-devops.md b/code-reviews/pr-reviews/azure-devops.md index 26a4dceb..7a9b7a1c 100644 --- a/code-reviews/pr-reviews/azure-devops.md +++ b/code-reviews/pr-reviews/azure-devops.md @@ -37,7 +37,7 @@ Before anyone in your organization can connect kluster to Azure DevOps, an admin 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 **Project Collection Administrator** in the organization can connect projects without repeating the consent step. See [Verify account permissions](#prerequisites) for the required role. ## Create a personal access token From d77e59f2da5d85ca6f80a20a020166ce200fbbd4 Mon Sep 17 00:00:00 2001 From: Alberto Viera Date: Thu, 9 Apr 2026 14:45:41 +0000 Subject: [PATCH 4/6] Fix link text in admin consent note to match anchor Co-Authored-By: Claude Opus 4.6 (1M context) --- code-reviews/pr-reviews/azure-devops.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/code-reviews/pr-reviews/azure-devops.md b/code-reviews/pr-reviews/azure-devops.md index 7a9b7a1c..f0a8b9d1 100644 --- a/code-reviews/pr-reviews/azure-devops.md +++ b/code-reviews/pr-reviews/azure-devops.md @@ -37,7 +37,7 @@ Before anyone in your organization can connect kluster to Azure DevOps, an admin 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, any **Project Collection Administrator** in the organization can connect projects without repeating the consent step. See [Verify account permissions](#prerequisites) for the required role. + 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. ## Create a personal access token From 741c2dd6ea9f4cd00badef62adff7b6933ef2049 Mon Sep 17 00:00:00 2001 From: Alberto Viera Date: Thu, 9 Apr 2026 14:49:02 +0000 Subject: [PATCH 5/6] Align intro paragraph with Project Collection Administrators requirement Co-Authored-By: Claude Opus 4.6 (1M context) --- code-reviews/pr-reviews/azure-devops.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/code-reviews/pr-reviews/azure-devops.md b/code-reviews/pr-reviews/azure-devops.md index f0a8b9d1..5265fc6f 100644 --- a/code-reviews/pr-reviews/azure-devops.md +++ b/code-reviews/pr-reviews/azure-devops.md @@ -8,7 +8,7 @@ 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. From 78b5feeed4855a71b3d25f0e01039f95fa64d42c Mon Sep 17 00:00:00 2001 From: Alberto Viera Date: Thu, 9 Apr 2026 14:50:49 +0000 Subject: [PATCH 6/6] Consolidate Azure DevOps admonitions to reduce visual noise - Fold permissions warning into the prerequisite bullet - Fold custom rules note into the admin consent admonition - Reduces page from 7 admonitions to 5 Co-Authored-By: Claude Opus 4.6 (1M context) --- code-reviews/pr-reviews/azure-devops.md | 10 ++-------- 1 file changed, 2 insertions(+), 8 deletions(-) diff --git a/code-reviews/pr-reviews/azure-devops.md b/code-reviews/pr-reviews/azure-devops.md index 5265fc6f..9ec79beb 100644 --- a/code-reviews/pr-reviews/azure-devops.md +++ b/code-reviews/pr-reviews/azure-devops.md @@ -16,20 +16,14 @@ Once connected, the bot reviews every new pull request and every new commit push --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. @@ -37,7 +31,7 @@ Before anyone in your organization can connect kluster to Azure DevOps, an admin 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, any member of **Project Collection Administrators** in the organization can connect projects without repeating the consent step. See [Prerequisites](#prerequisites) for the required role. + 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