Re: Terminology question about remote branches.

[David Kastrup <dak@gnu.org>]

Jeff King <peff@peff.net> writes:

> 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