- Notifications
You must be signed in to change notification settings - Fork69
docs: enhance FAQ page#145
Changes fromall commits
File filter
Filter by extension
Conversations
Uh oh!
There was an error while loading.Please reload this page.
Jump to
Uh oh!
There was an error while loading.Please reload this page.
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -5,149 +5,137 @@ description: Frequently asked questions about CodeRabbit. | ||
| sidebar_position: 9 | ||
| --- | ||
| import Tabs from '@theme/Tabs'; | ||
| import TabItem from '@theme/TabItem'; | ||
| ## General Questions {#general-questions} | ||
| ### How accurate is CodeRabbit? | ||
| > CodeRabbit demonstrates high accuracy in code reviews based on early adoption results. While 100% accuracy isn't guaranteed due to AI's evolving nature, our technology continuously improves through: | ||
| - Regular model updates | ||
| - Enhanced pattern recognition | ||
| - Growing language support | ||
| - Refined code analysis | ||
| ### Language Support | ||
| CodeRabbit works with all programming languages, with varying proficiency based on: | ||
| - Language popularity | ||
| - Available training data | ||
| - Community usage patterns | ||
| ### Data Security | ||
| <Tabs> | ||
| <TabItem value="storage" label="Code Storage" default> | ||
| - No persistent code storage | ||
| - Temporary cloning during review only | ||
| - Complete data isolation | ||
| - Immediate disposal post-review | ||
| </TabItem> | ||
| <TabItem value="training" label="Training Data"> | ||
| - Uses only public datasets | ||
| - No proprietary code usage | ||
| - Private repositories excluded | ||
| </TabItem> | ||
| </Tabs> | ||
| ### Organization Management | ||
| Switch between organizations easily: | ||
| 1. Click organization name (top-left corner) | ||
| 2. Select desired organization | ||
| 3. Access organization-specific settings | ||
|  | ||
|  | ||
tyaga001 marked this conversation as resolved. Show resolvedHide resolvedUh oh!There was an error while loading.Please reload this page. | ||
| ### Comparison with Other Tools | ||
| > Code reviews remain essential, whether the code is written by a human or a bot. This is mainly because the perspective of the reviewer differs from that of the code generator, whether human or machine. This distinction is precisely why human peer reviews have been effective for so long. While AI-powered code-generation tools like GitHub Copilot hold immense potential, it's important to recognize that these generators are still in their early stages and may not be equipped to auto-generate meaningful code for moderately complex applications. | ||
| #### vs AI Code Generators | ||
| - Provides review perspective different from code generation | ||
| - Complements tools like GitHub Copilot | ||
| - Focuses on code quality and best practices | ||
| #### vs Traditional Review Tools | ||
| - Context-aware feedback | ||
| - Actionable suggestions | ||
| - Direct commit capabilities | ||
| - AI-powered intent understanding | ||
| ## Usage and Configuration {#usage-and-configuration} | ||
| ### When Does CodeRabbit Review PRs? | ||
| - ✅ **New PRs**: Automatic review when created | ||
| - ✅ **New Commits**: Automatic review when pushed to any PR | ||
| - ⚡ **Older PRs**: Use `@coderabbitai review` to trigger manually | ||
| :::tip Pro Tip | ||
| Just created a PR right before installing CodeRabbit? or drop a `@coderabbitai full review` comment in old PR to get it reviewed. | ||
| ::: | ||
tyaga001 marked this conversation as resolved. Show resolvedHide resolvedUh oh!There was an error while loading.Please reload this page. | ||
|  | ||
| ### Customization Options | ||
| - **Language Settings**: Configure review language in repository settings | ||
| - **Review Rules**: Customize via [Review Instructions](./guides/review-instructions.md) | ||
| - **Branch Selection**: Default branch reviews enabled by default (configurable) | ||
| ### Access & Permissions | ||
| - Minimal repository access required | ||
| - Review permissions during installation | ||
| - Individual developer support available | ||
| ### Interaction Guide | ||
| Interact withCodeRabbitby: | ||
| 1. Replying directly to CodeRabbit comments | ||
| 2. Tagging `@coderabbitai` in PR discussions | ||
| 3. Adding review comments for specific lines | ||
| 4. Customize via [Review Instructions](./guides/review-instructions.md) | ||
| :::tip Collaboration Mode | ||
| When team members are active in PRs, use `@coderabbitai` to engage the bot. | ||
| ::: | ||
| ### Usage Limits | ||
| | Feature | Free/Trial | Pro Plan | | ||
| | -------------- | ----------------------------- | ------------- | | ||
| | Files per hour | 200 | 200 | | ||
| | Reviews | 3 back-to-back, then 3/hour | Higher limits | | ||
| | Conversations | 25 back-to-back, then 50/hour | Higher limits | | ||
tyaga001 marked this conversation as resolved. Show resolvedHide resolvedUh oh!There was an error while loading.Please reload this page. | ||
| :::note | ||
| In-trial and open-source plans have lower rate limits than the paid plan. In all cases, we re-allow further reviews/conversations after a brief timeout. | ||
| ::: | ||
| ## Integration Guide {#integration-guide} | ||
| ### Prerequisites | ||
| - Organization admin access | ||
| - Domain allowlist (GitLab: add `coderabbit.ai`) | ||
| - Default branch configuration | ||
| ### Quick Setup | ||
| 1. Sign up at [coderabbit.ai](https://coderabbit.ai) using your GitHub account | ||
| 2. Add your repository through the dashboard | ||
| 3. That's it. CodeRabbit will automatically start reviewing your PRs | ||
| :::tip Need Help? | ||
| Visit our [Support](./about/support.md) page for additional assistance or reach out to our team on [discord](http://discord.gg/coderabbit). | ||
tyaga001 marked this conversation as resolved. Show resolvedHide resolvedUh oh!There was an error while loading.Please reload this page. | ||
| ::: | ||
| Original file line number | Diff line number | Diff line change | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| @@ -107,6 +107,11 @@ LINEAR_PAT=[<linear-personal-access-token>] | ||||||||||||||||||||||||||||||
| OAUTH2_ENDPOINT=[<endpoint>] | ||||||||||||||||||||||||||||||
| OAUTH2_CLIENT_ID=[<client-id>] | ||||||||||||||||||||||||||||||
| OAUTH2_CLIENT_SECRET=[<client-secret>] | ||||||||||||||||||||||||||||||
| # Set to true to use the knowledge base features. | ||||||||||||||||||||||||||||||
| ON_PREM_KNOWLEDGE_BASE=[true] | ||||||||||||||||||||||||||||||
| # The branch which CodeRabbit will store the knowledge base json files in. | ||||||||||||||||||||||||||||||
| ON_PREM_KNOWLEDGE_BASE_BRANCH=[coderabbitai/data] | ||||||||||||||||||||||||||||||
Comment on lines +111 to +114 Contributor There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others.Learn more. 🛠️ Refactor suggestion Enhance documentation for knowledge base configuration The new environment variables need more detailed documentation to help users make informed decisions:
Consider expanding the documentation like this: # Set to true to use the knowledge base features.+# Knowledge base features allow CodeRabbit to store and learn from previous reviews,+# improving the quality of future code reviews. ON_PREM_KNOWLEDGE_BASE=[true]+ # The branch which CodeRabbit will store the knowledge base json files in.+# Default: coderabbitai/data+# This branch will be created automatically if it doesn't exist.+# Ensure the GitHub App has necessary permissions to create and write to this branch. ON_PREM_KNOWLEDGE_BASE_BRANCH=[coderabbitai/data] 📝 Committable suggestion
Suggested change
| ||||||||||||||||||||||||||||||
| ``` | ||||||||||||||||||||||||||||||
| :::note | ||||||||||||||||||||||||||||||