Re: [PATCH 0/6] doc: update-ref: amend old material and discuss symrefs
On Tue Oct 15, 2024 at 21:03, <kristofferhaugsbakk@fastmail.com> wrote:
Show 19 quoted lines
> From: Kristoffer Haugsbakk <code@khaugsbakk.name>
>
> (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 <bence@ferdinandy.com>