Johannes Schindelin [off-list ref] writes:
Remember, those who read "git for CVS users" are _unwilling_ to
spend the time reading git documentation (at least for the most
part). If they encounter something which is not useful to them,
they will not just ignore it, they will stop reading.
People who read documentation do this only in order to avoid reading
documentation, anyway? This must be about the most stupid argument to
refrain from augmenting documentation I have heard in a long time.
It may well be possible that some of the proposed additions don't have
a good place in the document. I have not checked so myself. But the
above criticism is not constructive for documentation writers since
its logical conclusion would boil down to "don't bother writing any
documentation".
--
David Kastrup