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

From: Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>
Date: Oct 20, 2024, 16:24 UTC
Message-ID: <cfa378cd-2724-4c7e-9a86-68f4859d2d65@app.fastmail.com>
In-Reply-To: <CAOLa=ZRAGmgfSHjAx6-1q9qV-aJ_Ciw=RZ6kpygqbSO+yAUEeg@mail.gmail.com>

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

Show 12 quoted lines

> 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