From: Junio C Hamano <junkio@cox.net>
Date: Fri, 11 May 2007 04:48:17 GMT
Subject: Re: [PATCH] user-manual: Use "git config --global" instead of editing ~/.gitconfig
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.