Re: [PATCH v3] doc: checkout: rewrite detached HEAD state explanation
- From
Julia Evans <julia@jvns.ca>
- Date
- Oct 16, 2026, 18:35 UTC
- Message-ID
- <7e888746-4220-494d-b8ab-00bdd5da5876@app.fastmail.com>
- In-Reply-To
- <xmqqzewdfuhm.fsf@gitster.g>
On Fri, Oct 16, 2026, at 1:03 PM, Junio C Hamano wrote:
Show 16 quoted lines
> "Julia Evans" <julia@jvns.ca> writes: > >> This is a case where if we really want to make sure it's clear, we need >> to go get feedback from users. There's likely a better way to explain it >> but I don't think that this conversation will result in an improvement. >> Really doing a good job of explaining HEAD is a pretty big project. >> >> It's not clear to me if you think the current wording is unusable >> or if you just think it could be better. > > Then let me make it clear. > > I do not know if your version is unusable or good enough, but if you > are going to take one version to guinea-pig readers to test and > polish starting from that version, I think what I gave you would > give us a better starting point.
I'm not planning to test this version on readers right now, no.
Here's what I wrote in the first email in this thread:
Often when rewriting these explanations I go through a process where I
ask users' feedback on the old explanation. Here I didn't do that
basically because that process takes a long time and I'm working on a
bunch of other time consuming docs projects so I did a quick rewrite
based on my previous experience explaining detached HEAD state to folks. I thought this could be a nice quick docs win on a topic which many
users find quite confusing. If the changes here are too controversial I
can drop it for now.