From: Bence Ferdinandy <bence@ferdinandy.com>
Date: Wed, 16 Oct 2024 08:51:45 GMT
Subject: Re: [PATCH 0/6] doc: update-ref: amend old material and discuss symrefs
Message-ID: <D4X3P9IU599M.1ENMB903CT197@ferdinandy.com>
In-Reply-To: <cover.1729017728.git.code@khaugsbakk.name>


On Tue Oct 15, 2024 at 21:03,  <kristofferhaugsbakk@fastmail.com> wrote:
> 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>