On Sun, Oct 20, 2024, at 13:13, karthik nayak wrote:

kristofferhaugsbakk@fastmail.com writes:

quoted

[…]
Such a safety warning is also much less relevant now, considering that
everyone who isn’t intentionally poking at the internal implementation
is using porcelain commands to manage `HEAD`.

[…]

In the new reftable backend, HEAD would simply exist as a placeholder.
So either we do as you did and remove this entirely or double down to
say that writing to HEAD directly is not supported. I don't have a
preference here, so this looks good!

I see now that I misread you.  I thought you were talking about the
commit message.  But you’re talking about the doc text.

I don’t think that this text needs to say that writing to `HEAD` is not
supported.  Now the doc has implied that writing to `HEAD` is an option
since 2005.  But I think that implication has been irrelevant for a long
time.  We’re far away from the time when people had to update `HEAD`
manually.

-- 
Kristoffer Haugsbakk