Re: [PATCH v3] doc: checkout: rewrite detached HEAD state explanation

["Julia Evans" <julia@jvns.ca>]

On Fri, Oct 16, 2026, at 1:03 PM, Junio C Hamano wrote:
> "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.