8000 Merge branch 'main' into feature/issue/362 · coderabbitai/coderabbit-docs@c401fdd · GitHub
[go: up one dir, main page]

Skip to content

Commit c401fdd

Browse files
Merge branch 'main' into feature/issue/362
2 parents 9efbfe8 + b3ffa58 commit c401fdd

File tree

9 files changed

+126
-68
lines changed

9 files changed

+126
-68
lines changed

docs/changelog.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,16 @@ description: The latest updates and changes to CodeRabbit.
55
sidebar_position: 13
66
---
77

8+
## July 3, 2025
9+
10+
### Enhanced Python Static Analysis: Flake8 Support
11+
12+
We're excited to announce enhanced Python static analysis capabilities with [Flake8](https://flake8.pycqa.org/) support!
13+
14+
[Flake8](https://flake8.pycqa.org/) is a Python linting utility that wraps PyFlakes, pycodestyle, and Mccabe to check your Python code for style and logical errors.
15+
16+
See our [tools documentation](https://docs.coderabbit.ai/tools/) for more details.
17+
818
## July 1, 2025
919

1020
### Enhanced Code Guidelines Support

docs/faq.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -205,12 +205,13 @@ In-trial and open-source plans have lower rate limits than the paid plan. In all
205205

206206
The following limits enforced _per developer_:
207207

208-
| Feature | Free Plan | Trial Plan | OSS Plan | Pro/Lite Plan |
209-
| ---------------- | ------------------------------------------ | ----------------------------- | ----------------------------- | ----------------------------- |
210-
| Files per hour | 200/hour | 200/hour | 200/hour | 400/hour |
211-
| Files per PR | 100 | 100 | 100 | 200 |
212-
| Reviews per hour | 3 back-to-back, then 2/hour (Summary only) | 4 back-to-back, then 3/hour | 3 back-to-back, then 2/hour | 5 back-to-back, then 4/hour |
213-
| Chat | N/A | 25 back-to-back, then 50/hour | 10 back-to-back, then 25/hour | 25 back-to-back, then 50/hour |
208+
| Feature | Free Plan | Trial Plan | OSS Plan | Pro/Lite Plan |
209+
| -------------------------------- | ------------------------------------------ | --------------------------------- | ----------------------------- | ----------------------------- |
210+
| Files per hour | 200/hour | 200/hour | 200/hour | 400/hour |
211+
| Files per PR | 100 | 100 | 100 | 200 |
212+
| Reviews per hour | 3 back-to-back, then 2/hour (Summary only) | 4 back-to-back, then 3/hour | 3 back-to-back, then 2/hour | 5 back-to-back, then 4/hour |
213+
| Reviews per hour (IDE Extension) | 1/hour | 5/hour (Pro trial), 1/hour(Other) | 1/hour | 5/hour (Pro), 1/hour(Lite) |
214+
| Chat | N/A | 25 back-to-back, then 50/hour | 10 back-to-back, then 25/hour | 25 back-to-back, then 50/hour |
214215

215216
## Integration Guide {#integration-guide}
216217

docs/guides/config-vscode.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,11 @@ The instructions on this page are specific to using the extension with VSCode. I
1414

1515
To navigate to the settings screen for the CodeRabbit VSCode extension, follow these steps:
1616

17-
1. In the activity bar, click the Extensions icon.
17+
1. Open the CodeRabbit activity bar/sidebar.
1818

19-
1. In the sidebar, under **Installed**, click the gear-shaped **Manage** icon in the CodeRabbit row.
19+
1. In the sidebar, click on gear shaped icon on top right(beside logout icon).
2020

21-
1. In the menu that appears, select **Settings**.
21+
1. You can also search for CodeRabbit: Settin 9E7A gs in the command palette to open the settings.
2222

2323
The settings screen contains the following configuration controls.
2424

@@ -32,6 +32,14 @@ The **Agent Type** setting lets you choose the extension's response to using the
3232

3333
- **Claude Code**: The extension opens the Terminal pane of your IDE and tries to use the `claude` command-line program to apply the suggested fix to your code. You need to have Claude Code installed for this option to be effective.
3434

35+
- **Codex CLI**: The extension opens the Terminal pane of your IDE and tries to use the `codex` command-line program to apply the suggested fix to your code. You need to have Codex CLI installed for this option to be effective.
36+
37+
- **Cline**: The extension opens the `Cline` sidebar and runs a task to apply the suggested fix to your code. You need to have the `Cline` extension installed for this option to be effective.
38+
39+
- **Roo**: The extension opens the `Roo` sidebar and runs a task to apply the suggested fix to your code. You need to have the `Roo` extension installed for this option to be effective.
40+
41+
- **Kilo Code**: The extension opens the `Kilo Code` sidebar and runs a task to apply the suggested fix to your code. You need to have the `Kilo Code` extension installed for this option to be effective.
42+
3543
- **Clipboard**: The extension copies prompt text describing the suggested fix to your clipboard. From there, you can manually paste the prompt into the coding AI agent that you use with your IDE.
3644

3745
For more information about the **Fix with AI** feature, see [Request help from your AI coding agent](/guides/use-vscode#agent).

docs/guides/initial-configuration.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -77,8 +77,9 @@ By default, CodeRabbit writes thorough code reviews with several sub-sections. I
7777

7878
## Adjust path-specific CodeRabbit behavior {#path}
7979

80-
These settings direct CodeRabbit to treat various files and and locations in
81-
your repository differently.
80+
You can give CodeRabbit additional instructions for reviewing specific files or
81+
locations in your repository, or configure CodeRabbit to disregard certain file paths
82+
during code reviews.
8283

8384
For an overview about using path-based instructions in CodeRabbit, see [Path-based instructions](/guides/review-instructions#path-based).
8485

docs/guides/use-vscode.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ You can let CodeRabbit automatically review commits that you make to your local
1818

1919
To perform an automatic review, follow these steps:
2020

21-
1. Perform a Git commit using VSCode. After you do this, a dialog appears in your VSCode window, asking **Would you like to start a review?**
21+
1. Perform a Git commit using VSCode or terminal. After you do this, a dialog appears in your VSCode window, asking **Would you like to start a review?**
2222

2323
1. Click **Yes**. The CodeRabbit sidebar appears in your VSCode window.
2424

docs/platforms/bitbucket-cloud.md

Lines changed: 56 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -13,90 +13,90 @@ CodeRabbit integrates with Bitbucket Cloud to enhance code review and collaborat
1313

1414
This guide will assist you in effectively integrating CodeRabbit with Bitbucket Cloud.
1515

16-
## Configure App Password
16+
## Configure API Token
1717

18-
To enable CodeRabbit to interact with your Bitbucket repositories, an app password is required. This token grants the necessary permissions for interacting with the Merge Requests and Discussions APIs.
18+
To enable CodeRabbit to interact with your Bitbucket repositories, an API token is required. This token grants the
19+
necessary permissions for interacting with the Bitbucket merge request and discussion APIs.
1920

2021
1. Create a new Bitbucket account specifically for CodeRabbit and treat it as a service account.
2122
2. Name the account "CodeRabbit".
22-
3. If your Bitbucket workspace requires two-step verification, then you must also enable two-step verification on this new account.
23-
4. Generate an App Password to enable seamless integration between CodeRabbit and your Bitbucket repositories.
23+
3. If your Bitbucket workspace requires two-step verification, then you must also enable two-step verification on this
24+
new account.
25+
4. Generate an API Token to enable seamless integration between CodeRabbit and your Bitbucket repositories.
2426

25-
We recommend creating a new user as a service account, associating this user to the workspace you'd like to install CodeRabbit on, and providing CodeRabbit with the app password to allow access. During the installation process, CodeRabbit will automatically configure the required webhook for seamless integration.
26-
27-
<div class="center-image">
28-
<img
29-
src="/img/integrations/bitbucket-app-password-modal.png"
30-
alt="Bitbucket user modal"
31-
width="1000"
32-
/>
33-
</div>
27+
We recommend creating a new user as a service account, associating this user to the workspace you'd like to install
28+
CodeRabbit on, and providing CodeRabbit with the API token to allow access. During the installation process, CodeRabbit
29+
will automatically configure the required webhook for seamless integration.
3430

3531
:::note
3632

37-
If you wish to change the review user, you must provide the app password for the new user who will post reviews and comments. However, this requires manually removing the previous user from the projects and associated webhooks. Once this is done, you will need to reinstall the CodeRabbit app for each project.
33+
If you wish to change the review user, you must provide the API token for the new user who will post reviews and
34+
comments. However, this requires manually removing the previous user from the projects and associated webhooks. Once
35+
this is done, you will need to reinstall the CodeRabbit app for each project.
3836

3937
:::
4038

4139
### Recommendations
4240

43-
- **Create a dedicated user for CodeRabbit** - This ensures the user is exclusively for CodeRabbit, allowing better access control.
41+
- **Create a dedicated user for CodeRabbit** - This ensures the user is exclusively for CodeRabbit, allowing better
42+
access control.
4443
- **Use "CodeRabbit" as the username** - This makes the user easily recognizable for future reference.
4544
- **Use a dedicated email address** - This helps in easy identification and management.
46-
- **Use the CodeRabbit logo as the profile picture** - This further ensures easy recognition. You can download our logo from [here](/img/integrations/logo.svg "download").
47-
- **Developer Access** Ensure the service account user has developer access to the projects that you wish to install CodeRabbit on.
45+
- **Use the CodeRabbit logo as the profile picture** - This further ensures easy recognition. You can download our logo
46+
from [here](/img/integrations/logo.svg "download").
47+
- **Developer Access** Ensure the service account user has developer access to the projects that you wish to install
48+
CodeRabbit on.
4849

4950
#### Key Points to Remember
5051

51-
- Code reviews will be attributed to the owner of the app password.
52+
- Code reviews will be attributed to the owner of the API token.
5253

53-
#### Generating an App password
54+
#### Generating an API token
5455

55-
Bitbucket provides an option to generate an app password for a new user. Follow these steps to generate the password:
56+
Bitbucket provides an option to generate an API token for a new user. Follow these steps to generate the token:
5657

57-
1. Log in using the user designated for CodeRabbit reviews. This user serves as a service account for managing reviews and related activities.
58-
2. Go to "Personal Bitbucket Settings".
59-
3. Choose **App passwords**.
60-
4. Click **Create app password**.
61-
5. Enter a label easily recognizable for this app passwords usage.
58+
1. Log in using the user designated for CodeRabbit reviews. This user serves as a service account for managing reviews
59+
and related activities.
60+
2. Go to [API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens).
61+
3. Click **Create API token with scopes**.
62+
4. Enter a name easily recognizable for this API token usage and an expiration date based on your plan of using the
63+
product.
64+
5. On next step select **Bitbucket**
6265
6. Ensure the following scopes are selected:
63-
1. Account - Read
64-
2. Issues - Write
65-
3. Workspace membership - Read
66-
4. Projects - Write
67-
5. Repositories - Write
68-
6. Pull requests - Write
69-
7. Webhooks - Read and write
70-
8. Pipelines - Read
71-
9. Runners - Read
66+
- read:account
67+
- read:user:bitbucket
68+
- write:issue:bitbucket
69+
- read:issue:bitbucket
70+
- read:workspace:bitbucket
71+
- admin:project:bitbucket
72+
- write:webhook:bitbucket
73+
- read:webhook:bitbucket
74+
- read:pipeline:bitbucket
75+
- read:runner:bitbucket
76+
- read:repository:bitbucket
77+
- write:repository:bitbucket
78+
- read:pullrequest:bitbucket
79+
- write:pullrequest:bitbucket
7280
7. Click **Create**
73-
8. Note down the app password as it will only be displayed once.
74-
75-
<div class="center-image">
76-
<img
77-
src="/img/integrations/bitbucket-app-password-page.png"
78-
alt="Bitbucket app password configuration page"
79-
/>
80-
</div>
81-
<div class="center-image">
82-
<img
83-
src="/img/integrations/bitbucket-app-password-permissions.png"
84-
alt="Bitbucket app password permissions"
85-
/>
86-
</div>
81+
8. Note down the API token as it will only be displayed once.
8782

88-
### Where to Provide CodeRabbit the App Password
83+
### Where to Provide CodeRabbit the API Token
8984

90-
By default, if no app password is provided, CodeRabbit will prompt you to provide one during the installation process. However, if you wish to provide the token beforehand, you can do so by navigating to the **Organization Settings** tab, and selecting the **Bitbucket User** tab on the sidebar. Once entering the app password, the password will be validated and saved for future use.
85+
By default, if no API token is provided, CodeRabbit will prompt you to provide one during the installation process.
86+
However, if you wish to provide the token beforehand, you can do so by navigating to the **Organization Settings** tab,
87+
and selecting the **Bitbucket User** tab on the sidebar. Once entering the API token, the token will be validated and
88+
saved for future use.
9189

92-
You can confirm the correct user is being selected by verifying the user ID shown on the UI with the user ID of the service account user you created.
90+
You can confirm the correct user is being selected by verifying the user ID shown on the UI with the user ID of the
91+
service account user you created.
9392

9493
---
9594

9695
### Installing CodeRabbit into your Bitbucket Repositories
9796

9897
1. Go to the [Repositories page](https://app.coderabbit.ai/settings/repositories) in the CodeRabbit app.
99-
2. Select the checkbox next to the repositories where you want to install CodeRabbit. To install it on all repositories at once, select the checkbox at the top.
98+
2. Select the checkbox next to the repositories where you want to install CodeRabbit. To install it on all repositories
99+
at once, select the checkbox at the top.
100100
3. Select **Install Repositories**.
101101

102102
<div class="center-image">
@@ -121,10 +121,12 @@ The webhook `https://coderabbit.ai/bitbucketHandler` will now be installed for t
121121

122122
:::note
123123

124-
If you are experiencing issues with the webhook, such as CodeRabbit not being able to access the repository, or not reviewing pull requests, you can manually delete the webhook to the repository.
124+
If you are experiencing issues with the webhook, such as CodeRabbit not being able to access the repository, or not
125+
reviewing pull requests, you can manually delete the webhook to the repository.
125126

126127
Then refresh the repository page in the CodeRabbit app and you can reinstall the webhook.
127128

128-
If you cannot install the webhook please check that your Bitbucket user has the necessary permissions to install the webhook and the App Password is properly configured.
129+
If you cannot install the webhook please check that your Bitbucket user has the necessary permissions to install the
130+
webhook and the API Token is properly configured.
129131

130132
:::

docs/reference/yaml-template.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -145,7 +145,6 @@ reviews:
145145
enabled: true
146146
htmlhint:
147147
enabled: true
148-
config_file: ""
149148
checkmake:
150149
enabled: true
151150
chat:

docs/tools/flake8.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
title: Flake8
3+
sidebar_label: Flake8
4+
description: CodeRabbit's guide to Flake8.
5+
---
6+
7+
```mdx-code-block
8+
import ProPlanNotice from '@site/src/components/ProPlanNotice.mdx';
9+
10+
<ProPlanNotice />
11+
```
12+
13+
[Flake8](https://flake8.pycqa.org/) is a Python linting utility that wraps PyFlakes, pycodestyle, and Mccabe to check your Python code for style and logical errors.
14+
15+
## Supported Files
16+
17+
Flake8 will run on files with the following extensions:
18+
19+
- `*.py`
20+
21+
## Features
22+
23+
Flake8 can detect many issues such as:
24+
25+
- Style violations (PEP 8)
26+
- Logical errors and unused imports
27+
- Code complexity issues
28+
- Syntax errors
29+
- And many more
30+
31+
## Links
32+
33+
- [Flake8 Official Website](https://flake8.pycqa.org/)
34+
- [Flake8 GitHub Repository](https://github.com/pycqa/flake8)
35+
- [Flake8 Documentation](https://flake8.pycqa.org/en/latest/)
36+
- [Flake8 Configuration](https://flake8.pycqa.org/en/latest/user/configuration.html)

docs/tools/list.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ For an overview of how CodeRabbit uses these tools when generating code reviews,
3636
| Plaintext | [LanguageTool][LanguageTool] | Grammar and Spell Checking |
3737
| Java | [PMD][PMD] | Code Quality |
3838
| Protobuf | [Buf][Buf] | Code Quality |
39-
| Python | [Ruff][Ruff], [Pylint][Pylint] | Code Quality |
39+
| Python | [Ruff][Ruff], [Pylint][Pylint], [Flake8][Flake8] | Code Quality |
4040
| Regal | [Regal][Regal] | Code Quality |
4141
| Ruby | [RuboCop][RuboCop], [Brakeman][Brakeman] | Code Quality, Code Security |
4242
| Rust | [Clippy][Clippy] | Code Quality |
@@ -86,3 +86,4 @@ For an overview of how CodeRabbit uses these tools when generating code reviews,
8686
[Checkmake]: /tools/checkmake.md
8787
[PHPMD]: /tools/phpmd.md
8888
[PHPCS]: /tools/phpcs.md
89+
[Flake8]: /tools/flake8.md

0 commit comments

Comments
 (0)
0