Files
pr-agent/docs/docs/faq/index.md

67 lines
3.9 KiB
Markdown
Raw Normal View History

2024-09-11 16:28:09 +03:00
# FAQ
2024-09-29 17:15:49 +03:00
??? note "Question: Can Qodo Merge serve as a substitute for a human reviewer?"
2024-09-11 16:36:27 +03:00
#### Answer:<span style="display:none;">1</span>
2024-09-11 16:28:09 +03:00
2024-09-29 17:15:49 +03:00
Qodo Merge is designed to assist, not replace, human reviewers.
2024-09-11 16:28:09 +03:00
2024-09-11 16:40:34 +03:00
Reviewing PRs is a tedious and time-consuming task often seen as a "chore". In addition, the longer the PR the shorter the relative feedback, since long PRs can overwhelm reviewers, both in terms of technical difficulty, and the actual review time.
2024-09-29 17:15:49 +03:00
Qodo Merge aims to address these pain points, and to assist and empower both the PR author and reviewer.
2024-09-11 16:28:09 +03:00
2024-09-29 17:15:49 +03:00
However, Qodo Merge has built-in safeguards to ensure the developer remains in the driver's seat. For example:
2024-09-11 16:28:09 +03:00
1. Preserves user's original PR header
2. Places user's description above the AI-generated PR description
3. Cannot approve PRs; approval remains reviewer's responsibility
4. The code suggestions are optional, and aim to:
- Encourage self-review and self-reflection
- Highlight potential bugs or oversights
- Enhance code quality and promote best practices
Read more about this issue in our [blog](https://www.codium.ai/blog/understanding-the-challenges-and-pain-points-of-the-pull-request-cycle/)
___
2024-09-11 16:28:09 +03:00
??? note "Question: I received an incorrect or irrelevant suggestion. Why?"
2024-09-11 16:36:27 +03:00
#### Answer:<span style="display:none;">2</span>
2024-09-11 16:28:09 +03:00
- Modern AI models, like Claude 3.5 Sonnet and GPT-4, are improving rapidly but remain imperfect. Users should critically evaluate all suggestions rather than accepting them automatically.
2024-09-11 16:40:34 +03:00
- AI errors are rare, but possible. A main value from reviewing the code suggestions lies in their high probability of catching **mistakes or bugs made by the PR author**. We believe it's worth spending 30-60 seconds reviewing suggestions, even if some aren't relevant, as this practice can enhances code quality and prevent bugs in production.
2024-09-11 16:28:09 +03:00
- The hierarchical structure of the suggestions is designed to help the user to _quickly_ understand them, and to decide which ones are relevant and which are not:
- Only if the `Category` header is relevant, the user should move to the summarized suggestion description.
- Only if the summarized suggestion description is relevant, the user should click on the collapsible, to read the full suggestion description with a code preview example.
2024-09-29 17:15:49 +03:00
- In addition, we recommend to use the [`extra_instructions`](https://qodo-merge-docs.qodo.ai/tools/improve/#extra-instructions-and-best-practices) field to guide the model to suggestions that are more relevant to the specific needs of the project.
- The interactive [PR chat](https://qodo-merge-docs.qodo.ai/chrome-extension/) also provides an easy way to get more tailored suggestions and feedback from the AI model.
2024-09-11 16:28:09 +03:00
___
2024-09-11 16:28:09 +03:00
??? note "Question: How can I get more tailored suggestions?"
2024-09-11 16:36:27 +03:00
#### Answer:<span style="display:none;">3</span>
2024-09-11 16:28:09 +03:00
2024-09-29 17:15:49 +03:00
See [here](https://qodo-merge-docs.qodo.ai/tools/improve/#extra-instructions-and-best-practices) for more information on how to use the `extra_instructions` and `best_practices` configuration options, to guide the model to more tailored suggestions.
2024-09-11 16:28:09 +03:00
___
2024-09-11 16:28:09 +03:00
??? note "Question: Will you store my code ? Are you using my code to train models?"
2024-09-11 16:36:27 +03:00
#### Answer:<span style="display:none;">4</span>
2024-09-11 16:28:09 +03:00
2024-09-29 17:15:49 +03:00
No. Qodo Merge strict privacy policy ensures that your code is not stored or used for training purposes.
2024-09-11 16:28:09 +03:00
2024-09-29 17:15:49 +03:00
For a detailed overview of our data privacy policy, please refer to [this link](https://qodo-merge-docs.qodo.ai/overview/data_privacy/)
2024-09-11 16:28:09 +03:00
___
2024-09-29 17:15:49 +03:00
??? note "Question: Can I use my own LLM keys with Qodo Merge?"
2024-09-11 16:36:27 +03:00
#### Answer:<span style="display:none;">5</span>
2024-09-11 16:28:09 +03:00
When you self-host, you use your own keys.
2024-09-29 17:15:49 +03:00
Qodo Merge Pro with SaaS deployment is a hosted version of Qodo Merge, where Qodo manages the infrastructure and the keys.
2024-09-11 16:40:34 +03:00
For enterprise customers, on-prem deployment is also available. [Contact us](https://www.codium.ai/contact/#pricing) for more information.
___