From: Junio C Hamano <junkio@cox.net>
Date: Sun, 10 Dec 2006 23:05:11 GMT
Subject: Re: [PATCH] Documentation/git-commit: rewrite to make it more end-user friendly.
Message-ID: <7vfybn2vyw.fsf@assigned-by-dhcp.cox.net>
In-Reply-To: <Pine.LNX.4.64.0612101704390.2630@xanadu.home>

Nicolas Pitre <nico@cam.org> writes:

>> Man pages are reference documentation, so I figure it's OK to sacrifice
>> a little newbie-friendliness for accuracy and concision.
>
> I disagree.  Clarity should be the first goal.  And the fact that even 
> modified files have to be specified is something worth enphasizing, 
> especially since this is not something other systems do.

Let's keep plumbing documentation technical reference material,
but allow more newbie friendliness in Porcelain-ish
documentation.