CodingGuidelines: once it is in, it is not worth the code churn
[gitweb.git] / Documentation / CodingGuidelines
index f424dbd75c80abb4d6fecce18f6fc25859bdcb00..c405b0b9dff81fa00c5aa03ba6cb2222dceac9f8 100644 (file)
@@ -18,6 +18,14 @@ code.  For Git in general, three rough rules are:
    judgement call, the decision based more on real world
    constraints people face than what the paper standard says.
 
+ - Fixing style violations while working on a real change as a
+   preparatory clean-up step is good, but otherwise avoid useless code
+   churn for the sake of conforming to the style.
+
+   "Once it _is_ in the tree, it's not really worth the patch noise to
+   go and fix it up."
+   Cf. http://article.gmane.org/gmane.linux.kernel/943020
+
 Make your code readable and sensible, and don't try to be clever.
 
 As for more concrete guidelines, just imitate the existing code