Re: with git update-ref?

>
> On Sun, Oct 13, 2024, at 14:09, karthik nayak wrote:
>>
>> I agree, the documentation here could use some cleanup. The confusion
>> here lies around
>>
>>     It also allows a "ref" file to be a symbolic pointer to another ref
>>     file by starting with the four-byte header sequence of "ref:".
>>
>> This is added to talk about how the command de-references symbolic refs,
>> but it can be misinterpreted to mean that it does support symbolic refs
>> on the top level.
>>
>> Do either of you want to take a stab at updating the documentation here?
>>
>>> That seems in line with a plumbing command.
>>>
>>> --
>>> Kristoffer Haugsbakk
>>
>> Attachments:
>> * signature.asc
>
> I wonder if the third (It also) and the fourth
> (about FS symlinks) could be removed. The
> third is confusing like Bernard said and the
> fourth doesn't seem relevant enough any more. Not relevant enough to be part of Description.
>
> And the "safety" paragraphs could be moved
> to its own section. Because it looks like it's meant as an advice to unlearn the habits of a Git user from, I don't know, 2005 maybe.