Re: [PATCH v2 2/6] Documentation/git-update-ref.txt: remove safety paragraphs

["Kristoffer Haugsbakk" <kristofferhaugsbakk@fastmail.com>]

On Sun, Oct 20, 2024, at 13:13, karthik nayak wrote:
> kristofferhaugsbakk@fastmail.com writes:
>> […]
>> 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