From: J. Bruce Fields <bfields@fieldses.org>
Date: Thu, 23 Apr 2009 17:57:17 GMT
Subject: Re: [doc] User Manual Suggestion
Message-ID: <20090423175717.GA30198@fieldses.org>
In-Reply-To: <m24owgqy0j.fsf@boostpro.com>

On Wed, Apr 22, 2009 at 03:38:52PM -0400, David Abrahams wrote:
> 
> http://www.kernel.org/pub/software/scm/git/docs/user-manual.html#how-to-check-out
> covers "git reset" way too early, IMO, before one has the conceptual
> foundation necessary to understand what it means to "modify the current
> branch to point at v2.6.17".  If this operation must be covered this
> early in the manual, it should probably not be until
> http://www.kernel.org/pub/software/scm/git/docs/user-manual.html#manipulating-branches

I agree; we should suggest just a git-checkout (to a detached HEAD)
instead, though that needs a little explanation so people aren't scared
by the warning message it gives.

I also have a longstanding todo to experiment with rewriting the
beginning to use detached heads more and defer branch management till
later.

--b.