Re: [PATCH v3] doc: checkout: rewrite detached HEAD state explanation
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Oct 16, 2026, 19:05 UTC
- Message-ID
- <xmqq33u5fouq.fsf@gitster.g>
- In-Reply-To
- <7e888746-4220-494d-b8ab-00bdd5da5876@app.fastmail.com>
"Julia Evans" <julia@jvns.ca> writes:
> I'm not planning to test this version on readers right now, no.
That is fine. But eventually we will reach the point where we have something we think is good enough to show to test readers, no? And I thought you were asking for help to improve the draft to reach that stage by sending the patch.
Show 11 quoted lines
> 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.
After a long process, you may forget which suggestions you chose not to adopt by the time you are ready to show the draft to your test readers, and those who spent their brain cycles reviewing it might not notice that their input has been forgotten, either. I was worried about that kind of waste.
Thanks.