style.txt: slightly better call for documenting

Sometimes we tend to "just" translate the code to human which doesn't really help; what usually helps is noting down what the code author intended to implement or fix, and what was the case for that.

style.txt: slightly better call for documenting
41d2644e · Michael Shigorin · 3b3cf4cc · 41d2644e
Commit 41d2644e authored Jan 10, 2016 by Michael Shigorin
Hide whitespace changes
Inline Side-by-side

Showing with 5 additions and 1 deletion

style.txt doc/style.txt +5 -1

No files found.
--- a/doc/style.txt
+++ b/doc/style.txt
@@ -9,7 +9,11 @@
  порой могут выясниться непредвиденные последствия;
 * документируйте на русском (README) или английском (README.en) языке
-  то, что написали или изменили.
+  то, что написали или изменили, если бы сами хотели прочесть описание
+  сделанного на месте другого человека; в любом случае старайтесь
+  внятно описывать коммиты, при необходимости также спрашивайте
+  совета: документация кода порой не менее важна, чем сам код,
+  и призвана не повторять его, но пояснять намерения и неочевидности.
 [float]
 === рекомендации ===