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