mirror of
https://github.com/rustdesk/rustdesk.git
synced 2026-09-21 03:40:59 +03:00
improve comment rules
This commit is contained in:
@@ -63,10 +63,9 @@
|
|||||||
|
|
||||||
### Comments
|
### Comments
|
||||||
|
|
||||||
* Keep them short: one line by default, three at most.
|
* Avoid comments unless they explain a non-obvious reason, constraint, or workaround.
|
||||||
* Say **why**, never what. If the code already says it, delete the comment.
|
* Never restate what the code does; prefer clearer code instead.
|
||||||
* A comment must never be longer than the code it describes.
|
* If the code is self-explanatory, add no comment.
|
||||||
* Applies to YAML, shell and Python too, not just Rust.
|
|
||||||
|
|
||||||
### Be minimally invasive
|
### Be minimally invasive
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user