coafile.rst: New section inheritance documentation

mridubhatnagar · mridubhatnagar · commit cf4ebcf95d28 · 2017-07-10T22:23:59.000+05:30
Use of explicit inheritance and addition of reason for deprecating implicit inheritance. Closes coala#428
diff --git a/Users/coafile.rst b/Users/coafile.rst
@@ -85,7 +85,9 @@ This is the same file without section inheritance::
   other = some_other_value
 
 All settings must be part of a section, so don't do this for implicit
-inheritance (this is also deprecated behavior)::
+inheritance (this is also deprecated behavior). Implicit inheritance
+was leading to a section automatically getting inherited to all other
+sections without semantically making sense.
 
   # bad!
   setting1 = 1
