From: Junio C Hamano <gitster@pobox.com>
Date: Sun, 30 Aug 2009 23:31:29 GMT
Subject: Re: [PATCH] Documentation/git-add.txt: Explain --patch option in layman terms
Message-ID: <7vr5usyj3i.fsf@alter.siamese.dyndns.org>
In-Reply-To: <87ab1gaol2.fsf@jondo.cante.net>

Jari Aalto <jari.aalto@cante.net> writes:

> I think the convention used in git's manual pages deviate from the
> standard practise. We could make the git manual pages into line of:
>
> - write all the first level headings in all caps: "HEADING LIKE THIS"
> - write second level heading: start Upper-lower: "Heading like this"
>
> Cf. rsync(1), ssh(1) etc. many pages prior git's existense.

Having seen that nothing happened after a separate thread that was also on
the documentation consistency:

    http://thread.gmane.org/gmane.comp.version-control.git/72163/focus=72213

I am having a hard time to decide how seriously I should take the above
comment from you.

Are you volunteering to coordinate such a change (in other words, you do
not necessarily have to do _all_ the work yourself, alone), or is it just
an idle speculation?