Re: [PATCH] user-manual: Use "git config --global" instead of editing ~/.gitconfig

From: Junio C Hamano <junkio@cox.net>
Date: May 11, 2007, 04:48 UTC
Message-ID: <7vejloezji.fsf@assigned-by-dhcp.cox.net>
In-Reply-To: <20070511034653.GB26896@fieldses.org>

"J. Bruce Fields" <bfields@fieldses.org> writes:

> So while I'm not convinced of the value of consistency here, if we have
> to have consistency, I'd rather standardize on config-file-editing.

I obviously agree with everything you said.

I do not think "consistency" should weigh too much in the teaching and learning process, which is what a manual is about. It is beneficial to make the readers aware, early in the process, that there typically are more than one ways to do things, one suitable for scripting and the other for interactive use. In the introductory part of the user-manual, I think it is a very good idea to give a bit of glimpse of what is going on under the hood, and config file is probably the easiest thing to give that warm feeling of something they can understand is going on to the readers.