From: Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Date: Sun, 13 Jun 2021 07:15:01 GMT
Subject: Re: [PATCH 0/2] Avoid gender pronouns
Message-ID: <87k0my1bgp.fsf@evledraar.gmail.com>
In-Reply-To: <20210611202819.47077-1-felipe.contreras@gmail.com>


On Fri, Jun 11 2021, Felipe Contreras wrote:

> The latest solution looking for a problem [1] is to use the actively
> debated among linguists singular "they" [2].
>
> Leaving aside the linguistic intricacies that not all singular "they" are
> equal [3], and the overwhelming sentiment that these kinds of political
> discussions don't provide value for this community [4], the "issue" can
> be easily solved by simply using different wording.
>
>   - The reviewer herself
>   + The reviewers themselves
>
> Problem solved.
>
> Cheers.
>
> [1] https://lore.kernel.org/git/pull.975.git.1623085069.gitgitgadget@gmail.com/
> [2] https://www.theatlantic.com/culture/archive/2013/01/singular-their-affront-good-writing/319329/
> [3] https://ahdictionary.tumblr.com/post/147597257733/updated-usage-note-they
> [4] https://lore.kernel.org/git/87wnrooa17.fsf@evledraar.gmail.com/
>
> Felipe Contreras (2):
>   doc: avoid using the gender of other people
>   comments: avoid using the gender of our users

This looks good to me, especially the reduction in verbosity in hunks
like:
	
	- * parameters to the callback, `strbuf_expand()` passes a context pointer,
	- * which can be used by the programmer of the callback as she sees fit.
	+ * parameters to the callback, `strbuf_expand()` passes a context
	+ * pointer with any kind of data.

The comment gives you the same information, but now it takes a shorter
time to read it.