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!