docs: improve guidance on code suggestions quality in improve documentation

This commit is contained in:
mrT23
2025-03-07 16:55:45 +02:00
parent c1fb76abcf
commit 1943662946

View File

@ -445,7 +445,7 @@ Note: Chunking is primarily relevant for large PRs. For most PRs (up to 500 line
## A note on code suggestions quality
- AI models for code are getting better and better, but they are not flawless. Not all the suggestions will be perfect, and a user should not accept all of them automatically. Critical reading and judgment are required. Mistakes of the AI are rare but can happen.
- AI models for code are getting better and better, but they are not flawless. Not all the suggestions will be perfect, and a user should not accept all of them automatically. Critical reading and judgment are required. Mistakes of the AI are rare but can happen, and it is usually quite easy for a human to spot them.
- The suggestions aim to enable the PR author to self-reflect on and improve their pull requests, while also alerting on any critical bugs that may have been identified. It's perfectly acceptable to implement only the suggestions you find valuable for your specific context.
- 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: