Re: Terminology question about remote branches.

From: David Kastrup <dak@gnu.org>
Date: Aug 5, 2007, 09:44 UTC
Message-ID: <85fy2yb9jn.fsf@lola.goethe.zz>
In-Reply-To: <20070805093232.GC12507@coredump.intra.peff.net>

Jeff King <peff@peff.net> writes:

Show 13 quoted lines

> On Sun, Aug 05, 2007 at 11:29:12AM +0200, David Kastrup wrote:
>
>> The main question is why I can't find this explained in this manner in
>> the documentation.  Are you going to put it in yourself, or should I
>> attempt doing it?
>
> I guess because nobody complained it wasn't there before. :) Some of the
> information is a bit under-the-hood for most end-users, but obviously in
> your case the lack of information was creating confusion about the
> terms.
>
> Why don't you take a stab at updating the documentation (since you are
> the one who knows which parts were confusing you),

Well, one problem is that there simply _is_ no part of the documentation where such an explanation would have a place. It does not fit in the man pages of git-branch/git-commit, it has some passing relation to the repository layout explanation (even though the latter should not be something that the user has to read and understand for basic operation), it may have some place in the user manual, but may be a bit technical/long for that. Or one places it into another isolated file and hopes that a user will stumble across it when in need of the information.

Hm. Probably the usermanual is the best option in the current scheme of things.

> and I will be more than happy to help with making sure the changes
> are accurate.

Thanks.

-- 
David Kastrup, Kriemhildstr. 15, 44793 Bochum