Re: [doc] User Manual Suggestion

From: J. Bruce Fields <bfields@fieldses.org>
Date: Apr 23, 2009, 17:57 UTC
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:

Show 7 quoted lines

> 
> 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.