From: Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>
Date: Wed, 16 Oct 2024 20:55:13 GMT
Subject: Re: [PATCH 4/6] doc: update-ref: remove confusing paragraph
Message-ID: <3af2273a-891d-4179-96c3-865b0e64bf08@app.fastmail.com>
In-Reply-To: <ZxAnO5zH1vtgRvLk@nand.local>

On Wed, Oct 16, 2024, at 22:51, Taylor Blau wrote:
> […]
>
> I think that it is worth saying that this concept is explained well
> throughout other parts of the documentation, including other parts of
> 'git-update-ref(1)', as well as the glossary content.
>
> I don't think that you necessarily need to mention that here. But at
> least I was initially confused thinking that this patch proposed
> removing the only mention of the special "ref:" syntax for symbolic
> references.
>
> But it does not, so I think that this patch as you wrote it is good.
> Let's keep reading...

You/a reader in general being in doubt is enough reason to mention some
other documentation source.  I’ll fix in the next version.

And thanks for reading!