Re: [PATCH v5 0/5] doc: git-push: clarify DESCRIPTION section

From: Junio C Hamano <gitster@pobox.com>
Date: Oct 6, 2025, 22:07 UTC
Message-ID: <xmqqa523ofau.fsf@gitster.g>
In-Reply-To: <pull.1964.v5.git.1759777131.gitgitgadget@gmail.com>

"Julia Evans via GitGitGadget" <gitgitgadget@gmail.com> writes:

Show 11 quoted lines

> I surveyed 16 Git users about the git push man page. Here's a rewrite of the
> DESCRIPTION section and the definition of <refspec> based on the feedback.
> The goal is to clarify it while communicating the same information. The most
> common piece of feedback was that folks didn't understand what the term
> "ref" means. Most of the users who said they did not understand the term
> "ref" have been using Git for 10+ years.
> ...
> changes in v5:
>
>  * remove a bad example of git branch --track, from Junio's review
>  * fix some formatting issues, from Jean-Noël's review

Thanks for working on this; I have no further comments to add.

Shall we mark the topic for 'next'?