Merge branch 'master' into create-pull-request/patch-1772429875

DMarinhoCodacy · web-flow · commit fd588fa51610 · 2026-03-05T15:08:30.000Z
diff --git a/docs/codacy-ai/codacy-ai.md b/docs/codacy-ai/codacy-ai.md
@@ -2,7 +2,7 @@
 
 ## What is Codacy AI?
 
-Codacy AI is a set of optional features integrated into the Software designed to optimise development workflows and elevate code quality standards through automated issue descriptions, actionable recommendations and false-positive detection, is available for the Customer.
+Codacy AI is a set of optional features integrated into the Software, designed to optimise development workflows and elevate code quality standards through automated issue descriptions, actionable recommendations and false-positive detection. These features are available for the Customer.
 
 Codacy AI utilizes only enterprise-grade instances of OpenAI and Google Gemini services with enhanced security, privacy, and data protection features. Customer Code processed through Codacy AI will not be used by Codacy, OpenAI, or any third-party AI provider for training, improving, or developing artificial intelligence models, machine learning algorithms, or any other automated systems.
 
@@ -66,9 +66,9 @@ More details about [False Positives here](../repositories/commits.md#false-posit
 !!! note
     AI Reviewer is currently only available on GitHub, for all Team and Business plans.
 
-_This feature leverages Google Gemini models, and is strictly opt-in: it will only run on repositories or projects where a repository admin has enabled it._
+_This feature leverages Google Gemini models, and is strictly opt-in; it will only run on repositories or organizations where an admin has enabled it._
 
-The AI Reviewer combines the reliability of deterministic, rule-based static code analysis with the power of AI. It draws in the necessary context from source code and PR metadata to ensure the business intent matches the technical outcome, and can catch logic gaps that conventional scanners (and human reviewers) often miss.
+The AI Reviewer combines the reliability of deterministic, rule-based static code analysis with the enhanced context and prioritization capabilities of AI. It draws in the necessary context from PR metadata, Jira ticket if [integration exists](../organizations/integrations/jira-integration.md), source code, and Codacy data to ensure the business intent matches the technical outcome, and can catch logic gaps that conventional scanners (and human reviewers) often miss.
 
 More details about [AI Reviewer here](../repositories-configure/integrations/github-integration.md#ai-reviewer).
 
@@ -80,6 +80,12 @@ More details about [AI Reviewer here](../repositories-configure/integrations/git
 4. Save your changes. Once enabled, Codacy will start adding a Summary to your pull requests based on the AI-enriched reviews.
 5. To request a PR review, click **Run Reviewer** in the Summary or call our [public API](https://api.codacy.com/api/api-docs#triggerpullrequestaireview). Your review will be published as soon as it's ready.
 
+#### Jira context for the AI Reviewer
+
+If the Jira integration is enabled, we will automatically attempt to detect the Jira ticket key (ABC-123, case-insensitive) in the Pull request metadata. If found, the ticket title and description will be used to enrich the context of our reviewer.
+
+More about the [Jira integration here](../organizations/integrations/jira-integration.md).
+
 #### Custom Instructions
 
 To improve the results of the AI Reviewer, you can provide custom instructions to the AI Reviewer. These instructions are specific to a repository and help the AI Reviewer understand the structure of the code, the business logic of the project, and your own preferences.
diff --git a/docs/organizations/integrations/jira-integration.md b/docs/organizations/integrations/jira-integration.md
@@ -33,6 +33,15 @@ To uninstall the Jira integration, open your organization **Integrations**, page
 !!! important
     Uninstalling the Jira integration as described above deletes all associated open items. You can alternatively uninstall the Jira integration on the Jira website: this doesn't delete anything, but it prevents Codacy from opening new Jira-related items.
 
+## AI reviewer context
+
+!!! tip
+    AI Reviewer is currently only available on GitHub, for all Team and Business plans.
+
+If the repository or organization has the AI Reviewer enabled, it will automatically check the Pull Request metadata for a Jira ticket key (ABC-123, case-insensitive). The title and description will be fetched to enrich the review context, and the process will cross-check the required deliverable and acceptance criteria with the existing code changes. 
+
+More details about [AI Reviewer here](../../repositories-configure/integrations/github-integration.md#ai-reviewer).
+
 ## Creating Jira tickets from issues, dependencies and files
 
 Installing the Jira integration enables the feature of creating Jira tickets from issues, dependencies and files
diff --git a/docs/release-notes/cloud/cloud-2026-03-github-integration-settings-changes.md b/docs/release-notes/cloud/cloud-2026-03-github-integration-settings-changes.md
@@ -0,0 +1,64 @@
+---
+rss_title: Codacy release notes RSS feed
+rss_href: /feed_rss_created.xml
+---
+
+# Changes to GitHub integration settings – March 2026
+
+!!! info "These changes apply only to GitHub"
+
+We are making two changes to the GitHub integration settings over the coming weeks. Both are handled automatically - you don't need to take any action.
+
+-   [**AI-enhanced comments (Beta) being deprecated for GitHub**](#ai-enhanced-comments) — AI-enhanced comments are being replaced by the [AI Reviewer](../../codacy-ai/codacy-ai.md#pr-reviewer) on March 17, 2026.
+-   [**Coverage summary moving to Pull request review**](#coverage-summary) — the Coverage summary setting is being removed; coverage data will soon be included in the Pull request review comment.
+
+## AI-enhanced comments (Beta) being deprecated on March 17, 2026 {: id="ai-enhanced-comments"}
+
+Codacy is deprecating the AI-enhanced comments (Beta) feature in favour of the [AI Reviewer](../../codacy-ai/codacy-ai.md#ai-reviewer), which provides a more accurate, comprehensive, and context-aware experience for identifying and addressing issues.
+
+On March 17, 2026, Codacy will migrate all repositories and organizations that have **AI-enhanced comments** enabled to the [AI Reviewer](../../codacy-ai/codacy-ai.md#ai-reviewer) and remove the setting.
+
+
+!!! note
+    Organizations with contractual restrictions on AI providers or content analysis scope will not be automatically migrated to the AI Reviewer. For these organizations, AI-enhanced comments will simply be disabled. The AI Reviewer can be enabled at any time from your [integration settings](../../repositories-configure/integrations/github-integration.md#ai-reviewer). For more information, contact your account manager or <support@codacy.com>.
+
+### What to expect
+
+-   On March 17, 2026, the AI-enhanced comments setting will be removed and any repository or organization where it is enabled will be migrated to the AI Reviewer.
+-   Repositories where AI-enhanced comments are not enabled will not have the AI Reviewer enabled automatically.
+-   The AI Reviewer defaults to **manual** mode, so your team won't receive unexpected reviews.
+
+### What do you need to do?
+
+Nothing is required. Codacy will handle the migration automatically.
+
+If you prefer, you can enable the AI Reviewer now in your organization and repository integration settings. If you enable it before March 17, 2026, we recommend manually disabling **AI-enhanced comments** at the same time to avoid duplicate comments on Pull Requests.
+
+If you have any further questions, contact <support@codacy.com>.
+
+### Why this change
+
+-   The [AI Reviewer](../../codacy-ai/codacy-ai.md#pr-reviewer) uses broader context from source code and PR metadata (and Jira tickets, if enabled), which improves accuracy and reduces noise.
+-   You can guide reviews with custom instructions using a `review.md` file in your repository.
+-   You can trigger reviews on demand from Pull Requests using the **Run review** button.
+
+## Coverage summary moving to Pull request review {: id="coverage-summary"}
+
+Codacy is consolidating coverage data into the Pull request review comment so that you get a complete picture of your code quality and security changes in a single place, without the need for a separate comment.
+
+In the coming weeks, Codacy will migrate all repositories and organizations that have **Coverage summary** enabled to **Pull request review**. On that date, the Coverage summary setting will be removed.
+
+### What to expect
+
+-   Coverage changes will appear alongside quality and security metrics in the Codacy Analysis Summary PR comment.
+-   The Coverage summary setting will be removed.
+-   The AI Reviewer is **not** automatically enabled as part of this migration.
+
+### What do you need to do?
+
+Nothing. Codacy will handle the migration automatically for any repository or organization that had Coverage summary enabled. If you didn't have this setting on, this won't affect you.
+
+## See also
+
+-   [GitHub integration](../../repositories-configure/integrations/github-integration.md)
+-   [AI Reviewer](../../codacy-ai/codacy-ai.md#pr-reviewer)
diff --git a/docs/repositories-configure/integrations/github-integration.md b/docs/repositories-configure/integrations/github-integration.md
@@ -30,7 +30,7 @@ Adds a report to your pull requests showing whether your pull requests and cover
 
 ![Pull request status check on GitHub](images/github-integration-pr-status.png)
 
-### AI Reviewer
+### Pull request review {: id="pull-request-review"}
 
 {%
     include-markdown "../../assets/includes/paid.md"
@@ -41,17 +41,26 @@ Adds a report to your pull requests showing whether your pull requests and cover
 !!! note
     This feature is only supported on GitHub.
 
-    If you choose to enable the AI Reviewer, consider disabling the AI-enhanced comments, as it may duplicate any comments on Codacy issues you receive.
+When enabled, Codacy posts a **Codacy's Analysis Summary** comment on your pull requests each time a new analysis completes, giving you a full overview of code quality,  security, complexity, and duplication metric changes, without requiring you to open the Codacy app.
 
-The AI Reviewer combines the reliability of deterministic, rule-based static code analysis with the power of AI. It draws in the necessary context from source code and PR metadata to ensure the business intent matches the technical outcome, and can catch logic gaps that conventional scanners (and human reviewers) often miss.
+#### Enable AI reviewer {: id="ai-reviewer"}
+
+!!! note
+    If you enable the AI Reviewer, consider disabling AI-enhanced comments to avoid receiving duplicate comments on Codacy issues.
+
+The AI Reviewer extends Pull request reviews with an AI-powered code analysis. It combines the reliability of deterministic, rule-based static code analysis with the enhanced context and prioritization capabilities of AI. It draws in the necessary context from PR metadata, Jira ticket if [integration exists](../../organizations/integrations/jira-integration.md), source code, and Codacy data to ensure the business intent matches the technical outcome, and can catch logic gaps that conventional scanners (and human reviewers) often miss.
 
 It provides feedback on missing or weak tests, complex or duplicated code, and keeps security concerns up to date. Beyond that, it adds contextual insights about whether the changes follow the requirements, business rules, and logic used in the project.
 
-!!! tip
-    Improve the AI Reviewer results by providing custom instructions. [Learn how to do it here](../../codacy-ai/codacy-ai.md#custom-instructions).
+Configure when the AI Reviewer runs using the **Run reviewer** setting:
 
-This setting can be enabled at a repository or organization level. Once enabled, Codacy will start adding a Summary to your pull requests based on the AI-enriched reviews. To request a PR review, click **Run Reviewer** in the Summary or call our [public API](https://api.codacy.com/api/api-docs#triggerpullrequestaireview). Your review will be published as soon as it's ready.
+| Mode | Behaviour |
+|------|-----------|
+| Manually | Click **Run Reviewer** in the pull request comment or call our [public API](https://api.codacy.com/api/api-docs#triggerpullrequestaireview) to trigger a review on demand. |
+| Automatically (first review only) | Codacy runs the reviewer once automatically when the pull request is opened, then requires manual triggering for subsequent updates. |
 
+!!! tip
+    Improve the AI Reviewer results by providing custom instructions. [Learn how to do it here](../../codacy-ai/codacy-ai.md#custom-instructions).
 
 ![AI Reviewer on Github](images/github-integration-ai-reviewer.png)
 
@@ -70,6 +79,9 @@ Shows an overall view of the changes in the pull request, including new issues a
 
 ### Coverage summaries
 
+!!! warning "Coverage summary is moving to Pull request review"
+    In the coming weeks, Codacy will include coverage data in the Pull request review comment and remove the Coverage summary setting. [Learn more](../../release-notes/cloud/cloud-2026-03-github-integration-settings-changes.md#coverage-summary).
+
 Adds a pull request comment showing an overall view of the coverage metrics for the pull request, including details about the data that Codacy used to calculate the coverage variation and diff coverage metrics.
 
 When there are new coverage results, Codacy updates the last coverage summary comment if it's included in the last 5 comments of the pull request. Otherwise, Codacy creates a new comment.
@@ -99,6 +111,9 @@ Adds comments on the lines of the pull request where Codacy finds new issues wit
 
 ### AI-enhanced comments
 
+!!! warning "AI-enhanced comments (Beta) is being deprecated on March 16, 2026"
+    This feature is being replaced by the AI Reviewer, which provides a more accurate and comprehensive experience. [Learn more](../../release-notes/cloud/cloud-2026-03-github-integration-settings-changes.md#ai-enhanced-comments).
+
 Adds AI-enhanced comments, providing insights and ready-to-commit AI-generated fixes for identified issues in cases where tool-suggested fixes are not supported. To enable this option, you must enable **Suggested fixes** first.
 
 {% include-markdown "../../assets/includes/ai-info.md" %}
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -690,7 +690,8 @@ nav:
           - release-notes/index.md
           - Cloud:
                 - 2026:
-                      - release-notes/cloud/cloud-2026-01.md  
+                      - release-notes/cloud/cloud-2026-03-github-integration-settings-changes.md
+                      - release-notes/cloud/cloud-2026-01.md
                       - release-notes/cloud/cloud-2026-01-adding-golangci-lint.md
                 - 2025:
                       - release-notes/cloud/cloud-2025-12.md
