Skip to content

Commit 137c873

Browse files
Merge branch 'main' into bitbucket_cloud_doc_page
2 parents f463a72 + c92ba04 commit 137c873

File tree

13 files changed

+178
-117
lines changed

13 files changed

+178
-117
lines changed

docs/changelog.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -186,7 +186,7 @@ You can now choose whether to auto-generate sequence diagrams in the PR Walkthro
186186

187187
We've refined the default settings to be less noisy and more actionable. Additionally, we've added new static analysis and security tools:
188188

189-
- **Yamllint**: A linter for YAML files
189+
- **YAMLlint**: A linter for YAML files
190190
- **Gitleaks**: A lightweight, open-source secret scanner to prevent security breaches
191191
- **Checkov**: Scans infrastructure as code for misconfigurations before they become security issues
192192

@@ -234,8 +234,8 @@ Users can now select between **Chill** and **Assertive** review tones to tailor
234234

235235
We are continually expanding our support for static analysis tools. We've recently added support for
236236

237-
- biome
238-
- hadolint
237+
- Biome
238+
- Hadolint
239239
- ast-grep.
240240

241241
Update your .coderabbit.yaml file or visit the settings page to enable or disable the tools you wish to use.
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
title: Upgrading App Permissions
3+
description: Learn how to upgrade CodeRabbit's GitHub App permissions when new features are added
4+
sidebar_label: Upgrading Permissions
5+
sidebar_position: 6
6+
---
7+
8+
Sometimes when we add new features to CodeRabbit, we need to request additional GitHub permissions. If you see a warning about permissions or resources not being accessible, you'll need to approve the new permissions. Here's how to do it:
9+
10+
1. Navigate to your organization or repository settings in GitHub
11+
2. Go to the "GitHub Apps" or "Installed GitHub Apps" section
12+
3. Find CodeRabbit in the list of installed apps
13+
4. Click "Configure"
14+
5. Review and accept the new permissions
15+
16+
![Permission warning example](../../static/img/getting-started/permission-warning.png)
17+
18+
![Granting updated permissions](../../static/img/getting-started/grant-permission.png)
19+
20+
Common reasons for permission updates include:
21+
22+
- Access to new GitHub features
23+
- Enhanced repository scanning capabilities
24+
- Additional workflow automation features
25+
- Improved security features
26+
27+
> Note: If you're not an organization admin, you may need to request approval from your organization administrators to update the permissions.
28+
29+
After accepting the new permissions, CodeRabbit will have the access it needs to function properly. If you continue to experience issues, try refreshing your browser or reaching out to our support team.

docs/guides/custom-reports.md

+54-1
Original file line numberDiff line numberDiff line change
@@ -274,10 +274,63 @@ Include:
274274
- Technical debt analysis
275275
```
276276

277-
### Advanced Formatting
277+
## Advanced Example Templates
278278

279279
Heres a more advanced example of a custom report template:
280280

281+
### **Good Day Release Report**
282+
283+
```text
284+
**GPT Specialization:**
285+
This GPT specializes in summarizing software release notes and optional summary paragraphs into a consistent, clear, and concise format. The goal is to streamline the presentation of release notes, making them easy to understand for a general audience. It prioritizes clarity, brevity, and coherence while highlighting important updates without unnecessary jargon.
286+
287+
**Release Note Structure:**
288+
289+
1. **Release Notes Organization**
290+
The items in the release notes may not be in the desired order. It is crucial to group similar items together meaningfully. Review the list after the release notes are created and reorder items within each heading based on relevance. Use **PRODUCT FEATURE GROUPS** to understand which items are related.
291+
292+
2. **General Release Note Guidelines**
293+
- The title should be: `GoodDay Release v${versionNumber}`
294+
295+
3. **Release Note Line Items**
296+
- Reword individual release lines to maintain a consistent tone (happy and fun)
297+
- Use past tense for descriptions
298+
- Items in the 🧼 Fixes group should begin with "Fixed"
299+
- Consolidate duplicate or closely related items, and list the associated GitHub pull requests as a comma-delimited list at the end (e.g., GH-123, GH-456)
300+
- Add links to Github App for each PR
301+
302+
4. **GitHub App Links**
303+
- each pr mentioned should include hyperlinking to the pull request such as [coderabbitai/mono/pull/2614](https://github.com/coderabbitai/mono/pull/2614)
304+
305+
5. **Grouping Release Note Line Items**
306+
- Replace any emoji in the provided content with the appropriate **RELEASE NOTE GROUP**
307+
- Order the **RELEASE NOTE GROUP** according to the structure below
308+
309+
6. **Release Note Groups**
310+
- 🚀 **Features**: New capabilities or enhancements
311+
- 🧼 **Fixes**: Bug fixes or problem resolutions
312+
- 🧰 **Maintenance**: Documentation, cleanup, or technical changes
313+
- 📚 **Other**: Anything else
314+
315+
7. **PR Label Uses**
316+
- Omit any PRs with the label `skip-changelog`
317+
- Use the labels from related pull requests to group items together
318+
- Map PR labels to release note groups using the table below:
319+
320+
| RELEASE NOTE GROUP | LABELS |
321+
|--------------------|-----------------|
322+
| 🚀 Features | feature, enhancement |
323+
| 🧼 Fixes | bug, fix |
324+
| 🧰 Maintenance | design, docs |
325+
| 📚 Other | other, tech |
326+
327+
8. **Final Checks**
328+
- Verify that the number of items matches the number of PRs included
329+
- Ensure the PR links match the PR number and reflect the content of the changes
330+
```
331+
332+
### **Nato's Special Report**
333+
281334
```text
282335
Generate a report of all pull requests in the following format:
283336

docs/tools/actionlint.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: Actionlint
3-
sidebar_label: Actionlint
4-
description: CodeRabbit's guide to Actionlint.
2+
title: actionlint
3+
sidebar_label: actionlint
4+
description: CodeRabbit's guide to actionlint.
55
---
66

77
```mdx-code-block
@@ -10,7 +10,7 @@ import ProPlanNotice from '@site/src/components/ProPlanNotice.mdx';
1010
<ProPlanNotice />
1111
```
1212

13-
[Actionlint](https://github.com/rhysd/actionlint/) is a static checker for
13+
[`actionlint`](https://github.com/rhysd/actionlint/) is a static checker for
1414
GitHub Actions workflow files.
1515

1616
## Files
@@ -26,4 +26,4 @@ CodeRabbit will use the default configuration.
2626

2727
## Links
2828

29-
- [Actionlint Configuration](https://github.com/rhysd/actionlint/blob/main/docs/config.md/)
29+
- [`actionlint` Configuration](https://github.com/rhysd/actionlint/blob/main/docs/config.md/)

docs/tools/circleci.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: CircleCi
3-
sidebar_label: CircleCi
4-
description: CodeRabbit's guide to CircleCi.
2+
title: CircleCI
3+
sidebar_label: CircleCI
4+
description: CodeRabbit's guide to CircleCI.
55
---
66

77
```mdx-code-block
@@ -10,11 +10,11 @@ import ProPlanNotice from '@site/src/components/ProPlanNotice.mdx';
1010
<ProPlanNotice />
1111
```
1212

13-
[CircleCi](https://circleci.com/) is a static checker and validator for circleci config files.
13+
[CircleCI](https://circleci.com/) is a static checker and validator for circleci config files.
1414

1515
## Files
1616

17-
We look for `CircleCi Configuration` files specifically in the following directory:
17+
We look for `CircleCI Configuration` files specifically in the following directory:
1818

1919
- `.circleci/config.yml`
2020
- `.circleci/config.yaml`
@@ -25,4 +25,4 @@ CodeRabbit will use the default configuration.
2525

2626
## Links
2727

28-
- [CircleCi Configuration](https://circleci.com/docs/configuration-reference/)
28+
- [CircleCI Configuration](https://circleci.com/docs/configuration-reference/)

docs/tools/detekt.md

+9-9
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: Detekt
3-
sidebar_label: Detekt
4-
description: CodeRabbit's guide to Detekt.
2+
title: detekt
3+
sidebar_label: detekt
4+
description: CodeRabbit's guide to detekt.
55
---
66

77
```mdx-code-block
@@ -10,23 +10,23 @@ import ProPlanNotice from '@site/src/components/ProPlanNotice.mdx';
1010
<ProPlanNotice />
1111
```
1212

13-
[Detekt](https://detekt.dev/) is a static code analysis tool specifically designed for Kotlin projects
13+
[`detekt`](https://detekt.dev/) is a static code analysis tool specifically designed for Kotlin projects
1414

1515
## Files
1616

17-
Detekt will run on files with the following extensions:
17+
`detekt` will run on files with the following extensions:
1818

1919
- `.kt`
2020
- `.kts`
2121

2222
## Configuration
2323

24-
Detekt uses a YAML style configuration file.
24+
`detekt` uses a YAML style configuration file.
2525

26-
Detekt supports the following config files:
26+
`detekt` supports the following config files:
2727

28-
- User-defined config file set at `reviews.tools.detekt.config_file` in your project's `.coderabbit.yaml` file or setting the "Review → Tools → Detekt → Config File" field in CodeRabbit's settings page.
28+
- User-defined config file set at `reviews.tools.detekt.config_file` in your project's `.coderabbit.yaml` file or setting the "Review → Tools → `detekt` → Config File" field in CodeRabbit's settings page.
2929

3030
## Links
3131

32-
- [Detekt Configuration](https://detekt.dev/docs/introduction/configurations/)
32+
- [`detekt` Configuration](https://detekt.dev/docs/introduction/configurations/)

docs/tools/markdownlint.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: Markdownlint
3-
sidebar_label: Markdownlint
4-
description: CodeRabbit's guide to Markdownlint.
2+
title: markdownlint
3+
sidebar_label: markdownlint
4+
description: CodeRabbit's guide to markdownlint.
55
---
66

77
```mdx-code-block
@@ -10,7 +10,7 @@ import ProPlanNotice from '@site/src/components/ProPlanNotice.mdx';
1010
<ProPlanNotice />
1111
```
1212

13-
[Markdownlint](https://github.com/DavidAnson/markdownlint) is a linter for Markdown.
13+
[`markdownlint-cli2`](https://github.com/DavidAnson/markdownlint) is a linter for Markdown.
1414

1515
## Files
1616

@@ -21,7 +21,7 @@ Markdownlint will run on files with the following extensions:
2121

2222
## Configuration
2323

24-
Markdownlint supports the following config files:
24+
`markdownlint-cli2` supports the following config files:
2525

2626
- `.markdownlint.jsonc`
2727
- `.markdownlint.json`
@@ -32,4 +32,4 @@ CodeRabbit will use the default settings based on the profile selected if no con
3232

3333
## Links
3434

35-
- [Markdownlint Configuration](https://github.com/DavidAnson/markdownlint?tab=readme-ov-file#configuration)
35+
- [`markdownlint-cli2` Configuration](https://github.com/DavidAnson/markdownlint?tab=readme-ov-file#configuration)

docs/tools/rubocop.md

+7-7
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: Rubocop
3-
sidebar_label: Rubocop
4-
description: CodeRabbit's guide to Rubocop.
2+
title: RuboCop
3+
sidebar_label: RuboCop
4+
description: CodeRabbit's guide to RuboCop.
55
---
66

77
```mdx-code-block
@@ -10,11 +10,11 @@ import ProPlanNotice from '@site/src/components/ProPlanNotice.mdx';
1010
<ProPlanNotice />
1111
```
1212

13-
[Rubocop](https://rubocop.org/) A Ruby static code analyzer and formatter, based on the community Ruby style guide.
13+
[RuboCop](https://rubocop.org/) A Ruby static code analyzer and formatter, based on the community Ruby style guide.
1414

1515
## Files
1616

17-
Rubocop will run on the following files and extensions:
17+
RuboCop will run on the following files and extensions:
1818

1919
- `.rb`
2020
- `.arb`
@@ -72,7 +72,7 @@ Rubocop will run on the following files and extensions:
7272

7373
## Configuration
7474

75-
Rubocop uses a YAML style configuration file. We look for the following files anywhere in the repository:
75+
RuboCop uses a YAML style configuration file. We look for the following files anywhere in the repository:
7676

7777
- `.rubocop.yml`
7878
- `.rubocop.yaml`
@@ -81,4 +81,4 @@ CodeRabbit will use the default settings based on the profile selected if no con
8181

8282
## Links
8383

84-
- [Rubocop Configuration](https://docs.rubocop.org/rubocop/1.65/configuration.html/)
84+
- [RuboCop Configuration](https://docs.rubocop.org/rubocop/1.65/configuration.html/)

docs/tools/semgrep.md

+25-46
Original file line numberDiff line numberDiff line change
@@ -10,14 +10,13 @@ import ProPlanNotice from '@site/src/components/ProPlanNotice.mdx';
1010
<ProPlanNotice />
1111
```
1212

13-
[Semgrep](https://semgrep.dev/) is a static analysis tool designed to scan code
14-
for security vulnerabilities and code quality issues.
13+
[Semgrep](https://github.com/semgrep/semgrep) is an open-source static analysis tool designed to scan code for security vulnerabilities and code quality issues.
1514

1615
## Configuration
1716

18-
Semgrep uses a YAML style configuration file. By default we will automatically
17+
Semgrep uses a YAML style configuration file. By default, we will automatically
1918
use the following files if any are set in the root directory of your
20-
repostitory.
19+
repository.
2120

2221
- `semgrep.yml` or `semgrep.yaml`
2322
- `semgrep.config.yml` or `semgrep.config.yaml`
@@ -28,10 +27,12 @@ Semgrep supports the following config files:
2827
project's `.coderabbit.yaml` file or setting the "Review → Tools → Semgrep →
2928
Config File" field in CodeRabbit's settings page.
3029

31-
Due to licensing, CodeRabbit does not ship with the [community-created Semgrep rules](https://github.com/returntocorp/semgrep-rules), but you're free to use these in your own `semgrep.yml` config file.
30+
Due to licensing, CodeRabbit does not ship with the [community-created Semgrep rules](https://github.com/returntocorp/semgrep-rules).
3231

3332
:::note
34-
CodeRabbit will only run Semgrep if your repository contains a Semgrep config file. This config must use the default file names or you must define the path to this file in the `.coderabbit.yaml` or config UI.
33+
34+
CodeRabbit will only run Semgrep if your repository contains a Semgrep config file. This config must use the default file names, or you must define the path to this file in the `.coderabbit.yaml` or config UI.
35+
3536
:::
3637

3738
## Links
@@ -41,43 +42,21 @@ CodeRabbit will only run Semgrep if your repository contains a Semgrep config fi
4142

4243
## Files
4344

44-
Semgrep will run on the following files and extensions:
45-
46-
- `Apex`
47-
- `Bash`
48-
- `.c`
49-
- `.cpp`
50-
- `.cs`
51-
- `.clj`
52-
- `.dart`
53-
- `Dockerfile`
54-
- `.ex`
55-
- `.html`
56-
- `.go`
57-
- `.java`
58-
- `.js`
59-
- `.jsx`
60-
- `.json`
61-
- `.jl`
62-
- `.jsonnet`
63-
- `.kt`
64-
- `.kts`
65-
- `Lisp`
66-
- `.lua`
67-
- `.ml`
68-
- `.php`
69-
- `.py`
70-
- `.r`
71-
- `.rb`
72-
- `.rs`
73-
- `.scala`
74-
- `Scheme`
75-
- `.sol`
76-
- `.swift`
77-
- `.tf`
78-
- `.ts`
79-
- `.tsx`
80-
- `.yaml`
81-
- `.xml`
82-
- `ERB`
83-
- `Jinja`
45+
Semgrep will run on the following files types:
46+
47+
- C/C++
48+
- C#
49+
- Go
50+
- Java
51+
- JavaScript
52+
- Kotlin
53+
- Python
54+
- TypeScript
55+
- Ruby
56+
- Rust
57+
- JSX
58+
- PHP
59+
- Scala
60+
- Swift
61+
- Terraform
62+
- JSON

0 commit comments

Comments
 (0)