Subject: Re: [PATCH 0/6] doc: update-ref: amend old material and discuss symrefs

From: "Bence Ferdinandy" <[email-masked]>
Date: Wed, 16 Oct 2024 10:51:45 +0200

On Tue Oct 15, 2024 at 21:03,  <[email-masked]> wrote:
> From: Kristoffer Haugsbakk <[email-masked]>
>
> (See the previous email for the context)
>
> This series removes or moves some old material in the update-ref doc and
> improves the discussion of symrefs, opting for a high-level description
> with some redundancy (see patch 5/6) in order to avoid a reported
> mistake/confusion.
>
> The end goal (after all patches are applied):
>
> • First paragraph (in Description) describes the first form
> • Second paragraph the second form
> • Third paragraph mentions symrefs and explains why `--stdin` supports
>   them
> • A new section whither the symlink (FS) vs. symrefs (`ref: ` files… or
>   strings nowadays with the different formats that refs can have?)
>   discussion is moved
> • Link update-ref to symbolic-ref and vice versa

Thanks, it seems much more clear to me this way!

Reviewed-by: Bence Ferdinandy <[email-masked]>