From: Julia Evans Date: Fri, 16 Oct 2026 18:35:19 GMT Subject: Re: [PATCH v3] doc: checkout: rewrite detached HEAD state explanation Message-ID: <7e888746-4220-494d-b8ab-00bdd5da5876@app.fastmail.com> In-Reply-To: On Fri, Oct 16, 2026, at 1:03 PM, Junio C Hamano wrote: > "Julia Evans" 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.