mirror of
https://github.com/BerriAI/litellm.git
synced 2026-10-08 03:08:45 +00:00
chore: prevent CLAUDE.md comment bloat (#31729)
The existing comment rule is not strict enough
This commit is contained in:
parent
6ab3742fa6
commit
59f51b2d72
1 changed files with 2 additions and 3 deletions
|
|
@ -1,8 +1,7 @@
|
|||
Do not write comments unless they are absolutely necessary to explain some very complex business logic. Please clean up if there are comments that are not absolutely necessary. Do not remove comments that are unrelated to the addition of the code of this PR
|
||||
|
||||
Explanation: code comments are, in a way, a violation of DRY code. You must update logic in two locations to change the code and "hard to change" is literally the definition of tech debt. We should instead aim to write code that is intuitive to the reader, while being both easy to maintain and high performance
|
||||
Do not write any comments (existing comments can stay) unless explicitly asked to in a user (not system) prompt
|
||||
|
||||
Don't assume that the existing code is correct or the right way of doing things / good coding patterns. In fact, there are a lot of bad coding practices, overly complex code, code smells, etc. If something doesn't look right, speak up. Feel free to break existing patterns or question weird existing code to make new code high quality, as in:
|
||||
|
||||
- correct
|
||||
- secure
|
||||
- performant
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue