From 33930a81758dabf6b3bc02e7ecd16c9390f41d7d Mon Sep 17 00:00:00 2001 From: Edgar Cerecerez Date: Mon, 28 Jul 2025 09:14:01 -0600 Subject: [PATCH 1/7] Updating bitbucket integration docs to account for on-prem Removed references to Bitbucket Cloud and left the more ambiguous Bitbucket to account for both on prem and cloud. --- docs/platforms/bitbucket-cloud.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/platforms/bitbucket-cloud.md b/docs/platforms/bitbucket-cloud.md index 385d46ed..422cf066 100644 --- a/docs/platforms/bitbucket-cloud.md +++ b/docs/platforms/bitbucket-cloud.md @@ -1,17 +1,17 @@ --- -title: "Bitbucket Cloud" -description: "Learn how to integrate CodeRabbit with Bitbucket Cloud." -sidebar_label: "Bitbucket Cloud" +title: "Bitbucket" +description: "Learn how to integrate CodeRabbit with Bitbucket." +sidebar_label: "Bitbucket" sidebar_position: 6 --- -CodeRabbit integrates with Bitbucket Cloud to enhance code review and collaboration by: +CodeRabbit integrates with Bitbucket to enhance code review and collaboration by: - Automatically initiating code reviews for newly created merge requests. - Displaying review comments and suggestions directly on merge requests. - Enabling seamless interaction with the CodeRabbit bot for real-time feedback and assistance. -This guide will assist you in effectively integrating CodeRabbit with Bitbucket Cloud. +This guide will assist you in effectively integrating CodeRabbit with Bitbucket. ## Configure API Token From b5162cc8a65bb989f67157c9b94eced50c356bc3 Mon Sep 17 00:00:00 2001 From: Edgar Cerecerez Date: Mon, 28 Jul 2025 10:00:25 -0600 Subject: [PATCH 2/7] Update bitbucket-cloud.md --- docs/platforms/bitbucket-cloud.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/platforms/bitbucket-cloud.md b/docs/platforms/bitbucket-cloud.md index 422cf066..a708441b 100644 --- a/docs/platforms/bitbucket-cloud.md +++ b/docs/platforms/bitbucket-cloud.md @@ -1,6 +1,6 @@ --- -title: "Bitbucket" -description: "Learn how to integrate CodeRabbit with Bitbucket." +title: "Bitbucket Cloud" +description: "Learn how to integrate CodeRabbit with Bitbucket Cloud." sidebar_label: "Bitbucket" sidebar_position: 6 --- @@ -11,7 +11,7 @@ CodeRabbit integrates with Bitbucket to enhance code review and collaboration by - Displaying review comments and suggestions directly on merge requests. - Enabling seamless interaction with the CodeRabbit bot for real-time feedback and assistance. -This guide will assist you in effectively integrating CodeRabbit with Bitbucket. +This guide will assist you in effectively integrating CodeRabbit with Bitbucket Cloud. [Click here](https://docs.coderabbit.ai/self-hosted/bitbucket) for instructions integrating Bitbucket Data Center with CodeRabit self-hosted edition. ## Configure API Token From 480f868554d532a7d8004cf84e572d1236176e92 Mon Sep 17 00:00:00 2001 From: Edgar Cerecerez Date: Thu, 7 Aug 2025 15:27:56 -0700 Subject: [PATCH 3/7] Delete future-development.md --- docs/future-development.md | 58 -------------------------------------- 1 file changed, 58 deletions(-) delete mode 100644 docs/future-development.md diff --git a/docs/future-development.md b/docs/future-development.md deleted file mode 100644 index e3c7c4d6..00000000 --- a/docs/future-development.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: CodeRabbit Features -sidebar_label: Future Development -description: Learn how CodeRabbit works in a pull request review. -sidebar_position: 12 ---- - -# Future Development - -We are actively iterating and refining CodeRabbit, and this is a sneak peek into the upcoming milestones and releases. We are focused on making the Applied AI review better than the median manual review. In addition to that, we are looking at a holistic user experience with various integrations and types of reviews. - -## Applied AI Improvements - -We are actively trying to make the application of Generative AI more useful, relevant, meaningful for the coder and reviewer journey. Our immediate focus is - -### Accuracy and Conciseness Enhancements - -- Refining knowledge base context understanding -- Implementing advanced summarization techniques -- Implementing a knowledge base feature library - -### Learning Refinements - -- We have made significant improvement of the learning Enhancing reinforcement learning based on the user feedback - -## New Feature Enhancements - -### Expanded Integrations - -We are integrating various tool chains to enable coders and reviewers to have a consistent experience irrespective of the tools. The immediate tools would be: - -- **Circle CI** -- **Jenkins** - -### Communication Tool Integrations - -Communication and the user experience of review via various communication tools will be key. We will start with integrations to Slack and Microsoft Teams and will be diving into the design engineering of these flows further: - -- **Slack**: Real-time notifications and interactive discussions -- **Microsoft Teams**: Code review conversations within the Microsoft ecosystem - -### Enhanced Review Capabilities - -These are additional capabilities that can also be reviewed in the same PR to accelerate the coder and reviewer journey. This includes pipeline failure analysis and resolution, as well as vulnerability assessment. - -#### Pipeline Failure Analysis - -- Automated analysis of CI/CD pipeline failures -- AI-driven suggestions for resolving issues -- Historical tracking of pipeline performance - -### Finishing Touches - -Finishing touches are about experience that often take developers time away from what they like doing best coding. But adding finishing touches is crucial and should follow the ontology and taxonomy. We will start by looking into specific areas such as documentation of code as an example. - -> Disclaimer: any product roadmap features mentioned below are only meant to outline -> our general product direction. This documentation is for informational purposes -> only and may not be incorporated into any contract. From 8d19387fef38d04d30005a2db334d1b05535285c Mon Sep 17 00:00:00 2001 From: Edgar Cerecerez Date: Thu, 7 Aug 2025 22:36:33 -0700 Subject: [PATCH 4/7] added mcp doc --- .../mcp-server-integrations.md | 52 +++++++++++++++++++ sidebars.ts | 11 +++- 2 files changed, 61 insertions(+), 2 deletions(-) create mode 100644 docs/context-enrichment/mcp-server-integrations.md diff --git a/docs/context-enrichment/mcp-server-integrations.md b/docs/context-enrichment/mcp-server-integrations.md new file mode 100644 index 00000000..04818323 --- /dev/null +++ b/docs/context-enrichment/mcp-server-integrations.md @@ -0,0 +1,52 @@ +--- +title: MCP integrations +description: MCP integrations allow CodeRabbit to access your documentation, project management tools, knowledge bases, Figma designs, and more. + +--- +:::caution +Pro feature — Early Access only +::: + +You can enable CodeRabbit to connect to external tools and data sources through the Model Context Protocol (MCP) integration. This allows CodeRabbit to serve as the client, and grants it with richer contextual understanding for: + +- Code reviews +- The validation step for code suggestions +- Chat in the PR + +Use the MCP integration as a way to access your documentation, project management tools, knowledge bases, Figma designs, and more. + +## Considerations + +A few things to keep in mind: + +- CodeRabbit acts as the MCP client, not the server. It ingests data. +- The constraint is understanding what MCP data can be helpful for code reviews. See above for how CodeRabbit uses MCP data. +- This approach unlocks integrations in a way that wasn’t possible before. You don’t have to wait for CodeRabbit to have a formal integration, if it has an MCP server, we can connect to it. + +## Setup + +### Configuration steps + +1. Navigate to Integrations Page within your CodeRabbit app settings and select the new MCP Server tab +2. To add a new MCP server, click "Add MCP Integration" and provide your server connection details along with the name +3. Complete the authentication process for your MCP server +4. Enable or disable individual MCP tools for each server + +## How it works + +### During code reviews + +CodeRabbit automatically calls relevant MCP tools during analysis to: + +* Gather additional review context. +* Validate and enhance suggested review comments. + +Enhanced review comments will include enriched insights while maintaining your existing workflow. Tools used during analysis are listed under "Additional context used." + +### In chat interactions + +MCP integration enhances chat by: + +* Retrieving contextual information based on discussion topics +* Accessing external documentation and knowledge bases + diff --git a/sidebars.ts b/sidebars.ts index 487a363b..b8459b09 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -127,7 +127,7 @@ const sidebars: SidebarsConfig = { { type: "category", collapsed: true, - label: "Review local changes", + label: "IDE extensions", items: [ "guides/about-vscode", "guides/install-vscode", @@ -137,6 +137,14 @@ const sidebars: SidebarsConfig = { "guides/uninstall-vscode", ], }, + { + type: "category", + collapsed: true, + label: "Context enrichment", + items: [ + "context-enrichment/mcp-server-integrations", + ], + }, { type: "category", collapsed: true, @@ -226,7 +234,6 @@ const sidebars: SidebarsConfig = { "overview/why-coderabbit", "faq", "early-access", - "future-development", "changelog", ], }, From 791952c551b8f75ca9cbdda85463a78295cff293 Mon Sep 17 00:00:00 2001 From: Edgar Cerecerez Date: Thu, 7 Aug 2025 23:08:34 -0700 Subject: [PATCH 5/7] bug fixes --- docs/finishing-touches/_category_.yaml | 4 ++++ docs/finishing-touches/docstrings.md | 2 +- docs/finishing-touches/index.md | 15 +++++++++++++++ docs/finishing-touches/unit-test-generation.md | 2 +- docs/guides/initial-configuration.md | 2 +- docs/guides/issue-creation.md | 2 +- docs/reference/configuration.md | 2 +- 7 files changed, 24 insertions(+), 5 deletions(-) create mode 100644 docs/finishing-touches/index.md diff --git a/docs/finishing-touches/_category_.yaml b/docs/finishing-touches/_category_.yaml index 81a96253..1bd50e46 100644 --- a/docs/finishing-touches/_category_.yaml +++ b/docs/finishing-touches/_category_.yaml @@ -2,3 +2,7 @@ label: Finishing Touches position: 8 collapsible: true collapsed: true +link: + type: generated-index + title: Finishing Touches + slug: /finishing-touches diff --git a/docs/finishing-touches/docstrings.md b/docs/finishing-touches/docstrings.md index c504fa8a..dd4f6467 100644 --- a/docs/finishing-touches/docstrings.md +++ b/docs/finishing-touches/docstrings.md @@ -11,7 +11,7 @@ import ProPlanNotice from '@site/src/components/ProPlanNotice.mdx'; # Docstrings -Docstrings generation is part of the [finishing touches](/future-development#finishing-touches). +Docstrings generation is part of the [Finishing Touches](/finishing-touches). ## Usage diff --git a/docs/finishing-touches/index.md b/docs/finishing-touches/index.md new file mode 100644 index 00000000..0dda55c8 --- /dev/null +++ b/docs/finishing-touches/index.md @@ -0,0 +1,15 @@ +--- +id: finishing-touches +title: Finishing Touches +description: Enhance your pull requests with automated docstrings and unit test generation. +slug: /finishing-touches +--- + +Finishing Touches features help you polish pull requests after review: + +- [Docstrings](/finishing-touches/docstrings) +- [Unit Test Generation](/finishing-touches/unit-test-generation) + +Use these tools to improve documentation and test coverage before merging. + + diff --git a/docs/finishing-touches/unit-test-generation.md b/docs/finishing-touches/unit-test-generation.md index 71fe5431..d2e7ac11 100644 --- a/docs/finishing-touches/unit-test-generation.md +++ b/docs/finishing-touches/unit-test-generation.md @@ -15,7 +15,7 @@ This feature is in beta. # Unit Test Generation -Unit Test Generation is part of the [finishing touches](/future-development#finishing-touches). +Unit Test Generation is part of the [Finishing Touches](/finishing-touches). ## Usage diff --git a/docs/guides/initial-configuration.md b/docs/guides/initial-configuration.md index 5cea2afd..26fc3a2b 100644 --- a/docs/guides/initial-configuration.md +++ b/docs/guides/initial-configuration.md @@ -70,7 +70,7 @@ By default, CodeRabbit writes thorough code reviews with several sub-sections. I - [Sequence diagrams](/reference/configuration#sequence-diagrams): includes a visual diagram of object interactions. - [Assess linked issues](/reference/configuration#assess-linked-issues): assesses how well the pull request addresses any linked issues. - [Related issues](/reference/configuration#related-issues): lists issues found in your issue tracker that might be related to this pull request. -- [Related pull requests](/reference/configuration#realted-prs): lists pull requests that might be related to this pull request. +- [Related pull requests](/reference/configuration#related-prs): lists pull requests that might be related to this pull request. - [Suggested labels](/reference/configuration#suggested-labels): Suggests labels for this pull request. - [Suggested reviewers](/reference/configuration#suggested-reviewers): automatically suggest reviewers for PR - [Poem](/reference/configuration#poem): generates a short poem about this pull request. diff --git a/docs/guides/issue-creation.md b/docs/guides/issue-creation.md index f6228b57..61928e7a 100644 --- a/docs/guides/issue-creation.md +++ b/docs/guides/issue-creation.md @@ -37,7 +37,7 @@ To create Jira issues, ensure you have [configured the Jira integration](../inte ### Linear -Make sure you have [set up the Linear integration](../integrations/issue-integrations.md#linear) to create Linear issues. +Make sure you have [set up the Linear integration](../integrations/issue-integrations.md#Linear) to create Linear issues. ## Tips for Issue Creation diff --git a/docs/reference/configuration.md b/docs/reference/configuration.md index d95fbaa0..14b7e32e 100644 --- a/docs/reference/configuration.md +++ b/docs/reference/configuration.md @@ -1980,7 +1980,7 @@ Specify the scope of learnings to use for the knowledge base. 'local' uses the r You can define a list of paths that guide CodeRabbit to your organization's code guidelines. If you do, then CodeRabbit applies these guidelines to its code reviews. For more -information, see [Code Guidelines](/integrations/knowledge-base#code_guidelines). +information, see [Code Guidelines](/integrations/knowledge-base#code-guidelines). #### Enable code guidelines From bca2d8af936f0b881be04b2f0cfdf09dca98737d Mon Sep 17 00:00:00 2001 From: Edgar Cerecerez Date: Thu, 7 Aug 2025 23:17:49 -0700 Subject: [PATCH 6/7] fixed lint errors. --- .../mcp-server-integrations.md | 27 +++++++++---------- docs/finishing-touches/index.md | 2 -- docs/platforms/bitbucket-cloud.md | 2 +- sidebars.ts | 4 +-- 4 files changed, 15 insertions(+), 20 deletions(-) diff --git a/docs/context-enrichment/mcp-server-integrations.md b/docs/context-enrichment/mcp-server-integrations.md index 04818323..49e943bf 100644 --- a/docs/context-enrichment/mcp-server-integrations.md +++ b/docs/context-enrichment/mcp-server-integrations.md @@ -1,35 +1,35 @@ --- title: MCP integrations description: MCP integrations allow CodeRabbit to access your documentation, project management tools, knowledge bases, Figma designs, and more. - --- + :::caution Pro feature — Early Access only ::: You can enable CodeRabbit to connect to external tools and data sources through the Model Context Protocol (MCP) integration. This allows CodeRabbit to serve as the client, and grants it with richer contextual understanding for: -- Code reviews -- The validation step for code suggestions +- Code reviews +- The validation step for code suggestions - Chat in the PR -Use the MCP integration as a way to access your documentation, project management tools, knowledge bases, Figma designs, and more. +Use the MCP integration as a way to access your documentation, project management tools, knowledge bases, Figma designs, and more. ## Considerations A few things to keep in mind: -- CodeRabbit acts as the MCP client, not the server. It ingests data. -- The constraint is understanding what MCP data can be helpful for code reviews. See above for how CodeRabbit uses MCP data. +- CodeRabbit acts as the MCP client, not the server. It ingests data. +- The constraint is understanding what MCP data can be helpful for code reviews. See above for how CodeRabbit uses MCP data. - This approach unlocks integrations in a way that wasn’t possible before. You don’t have to wait for CodeRabbit to have a formal integration, if it has an MCP server, we can connect to it. ## Setup ### Configuration steps -1. Navigate to Integrations Page within your CodeRabbit app settings and select the new MCP Server tab -2. To add a new MCP server, click "Add MCP Integration" and provide your server connection details along with the name -3. Complete the authentication process for your MCP server +1. Navigate to Integrations Page within your CodeRabbit app settings and select the new MCP Server tab +2. To add a new MCP server, click "Add MCP Integration" and provide your server connection details along with the name +3. Complete the authentication process for your MCP server 4. Enable or disable individual MCP tools for each server ## How it works @@ -38,8 +38,8 @@ A few things to keep in mind: CodeRabbit automatically calls relevant MCP tools during analysis to: -* Gather additional review context. -* Validate and enhance suggested review comments. +- Gather additional review context. +- Validate and enhance suggested review comments. Enhanced review comments will include enriched insights while maintaining your existing workflow. Tools used during analysis are listed under "Additional context used." @@ -47,6 +47,5 @@ Enhanced review comments will include enriched insights while maintaining your e MCP integration enhances chat by: -* Retrieving contextual information based on discussion topics -* Accessing external documentation and knowledge bases - +- Retrieving contextual information based on discussion topics +- Accessing external documentation and knowledge bases diff --git a/docs/finishing-touches/index.md b/docs/finishing-touches/index.md index 0dda55c8..824fc5e8 100644 --- a/docs/finishing-touches/index.md +++ b/docs/finishing-touches/index.md @@ -11,5 +11,3 @@ Finishing Touches features help you polish pull requests after review: - [Unit Test Generation](/finishing-touches/unit-test-generation) Use these tools to improve documentation and test coverage before merging. - - diff --git a/docs/platforms/bitbucket-cloud.md b/docs/platforms/bitbucket-cloud.md index a708441b..5813e5eb 100644 --- a/docs/platforms/bitbucket-cloud.md +++ b/docs/platforms/bitbucket-cloud.md @@ -11,7 +11,7 @@ CodeRabbit integrates with Bitbucket to enhance code review and collaboration by - Displaying review comments and suggestions directly on merge requests. - Enabling seamless interaction with the CodeRabbit bot for real-time feedback and assistance. -This guide will assist you in effectively integrating CodeRabbit with Bitbucket Cloud. [Click here](https://docs.coderabbit.ai/self-hosted/bitbucket) for instructions integrating Bitbucket Data Center with CodeRabit self-hosted edition. +This guide will assist you in effectively integrating CodeRabbit with Bitbucket Cloud. [Click here](https://docs.coderabbit.ai/self-hosted/bitbucket) for instructions integrating Bitbucket Data Center with CodeRabit self-hosted edition. ## Configure API Token diff --git a/sidebars.ts b/sidebars.ts index b8459b09..31081f0c 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -141,9 +141,7 @@ const sidebars: SidebarsConfig = { type: "category", collapsed: true, label: "Context enrichment", - items: [ - "context-enrichment/mcp-server-integrations", - ], + items: ["context-enrichment/mcp-server-integrations"], }, { type: "category", From 0620d73d456f8b16c61114714a9067ef4e8e8333 Mon Sep 17 00:00:00 2001 From: Edgar Cerecerez Date: Thu, 7 Aug 2025 23:32:22 -0700 Subject: [PATCH 7/7] lint issues continued. --- .../mcp-server-integrations.md | 24 +++++++++---------- sidebars.ts | 4 +--- 2 files changed, 13 insertions(+), 15 deletions(-) diff --git a/docs/context-enrichment/mcp-server-integrations.md b/docs/context-enrichment/mcp-server-integrations.md index ab9b63ff..3d9334ad 100644 --- a/docs/context-enrichment/mcp-server-integrations.md +++ b/docs/context-enrichment/mcp-server-integrations.md @@ -9,27 +9,27 @@ Pro feature — Early Access only You can enable CodeRabbit to connect to external tools and data sources through the Model Context Protocol (MCP) integration. This allows CodeRabbit to serve as the client, and grants it with richer contextual understanding for: -- Code reviews -- The validation step for code suggestions +- Code reviews +- The validation step for code suggestions - Chat in the PR -Use the MCP integration as a way to access your documentation, project management tools, knowledge bases, Figma designs, and more. +Use the MCP integration as a way to access your documentation, project management tools, knowledge bases, Figma designs, and more. ## Considerations A few things to keep in mind: -- CodeRabbit acts as the MCP client, not the server. It ingests data. -- The constraint is understanding what MCP data can be helpful for code reviews. See above for how CodeRabbit uses MCP data. +- CodeRabbit acts as the MCP client, not the server. It ingests data. +- The constraint is understanding what MCP data can be helpful for code reviews. See above for how CodeRabbit uses MCP data. - This approach unlocks integrations in a way that wasn't possible before. You don't have to wait for CodeRabbit to have a formal integration, if it has an MCP server, we can connect to it. ## Setup ### Configuration steps -1. Navigate to Integrations Page within your CodeRabbit app settings and select the new MCP Server tab -2. To add a new MCP server, click "Add MCP Integration" and provide your server connection details along with the name -3. Complete the authentication process for your MCP server +1. Navigate to Integrations Page within your CodeRabbit app settings and select the new MCP Server tab +2. To add a new MCP server, click "Add MCP Integration" and provide your server connection details along with the name +3. Complete the authentication process for your MCP server 4. Enable or disable individual MCP tools for each server ## How it works @@ -38,8 +38,8 @@ A few things to keep in mind: CodeRabbit automatically calls relevant MCP tools during analysis to: -* Gather additional review context. -* Validate and enhance suggested review comments. +- Gather additional review context. +- Validate and enhance suggested review comments. Enhanced review comments will include enriched insights while maintaining your existing workflow. Tools used during analysis are listed under "Additional context used." @@ -47,5 +47,5 @@ Enhanced review comments will include enriched insights while maintaining your e MCP integration enhances chat by: -* Retrieving contextual information based on discussion topics -* Accessing external documentation and knowledge bases +- Retrieving contextual information based on discussion topics +- Accessing external documentation and knowledge bases diff --git a/sidebars.ts b/sidebars.ts index b8459b09..31081f0c 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -141,9 +141,7 @@ const sidebars: SidebarsConfig = { type: "category", collapsed: true, label: "Context enrichment", - items: [ - "context-enrichment/mcp-server-integrations", - ], + items: ["context-enrichment/mcp-server-integrations"], }, { type: "category",