Re: [PATCH v2 1/5] doc: git-checkout: clarify intro

From: Julia Evans <julia@jvns.ca>
Date: Sep 2, 2025, 17:14 UTC
Message-ID: <a9351a8a-09eb-4fc7-92d2-fff5e504dbcc@app.fastmail.com>
In-Reply-To: <xmqq1poup1am.fsf@gitster.g>

Show 6 quoted lines

> You seem to have forgotten to update the proposed log message ...
>
> https://lore.kernel.org/git/de40e0ed-ca12-41b0-acd0-3c594078cc14@app.fastmail.com/
>
> ... to avoid making it just an enumeration of "these random things
> were done in this patch" (and instead tell a coherent story).

Thanks for the reminder, will work on that. I just realized today that I can use `lazygit` to make it much faster to edit my log messages :)

Show 7 quoted lines

> I do not understand "switches commits".  When you move to a commit
> (i.e. your HEAD can point directly at a commit without referring to
> any branch), are you switching one commit with another?  I do not
> think users would view it that way.
>
> Phrasing it with "switch to" may make it easier to handle.  Then
> your previous state would not matter as much.

Agreed that "switches commits" is weird, will use "switches to".