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

[Junio C Hamano <gitster@pobox.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.

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