Re: [PATCH] Documentation: enhanced "git for CVS users" doc about shared repositories

From: David Kastrup <dak@gnu.org>
Date: Nov 7, 2007, 09:09 UTC
Message-ID: <864pfyfmmb.fsf@lola.quinscape.zz>
In-Reply-To: <Pine.LNX.4.64.0711070053320.4362@racer.site>

Johannes Schindelin <Johannes.Schindelin@gmx.de> 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