Re: [PATCH 0/2] Avoid gender pronouns
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Jun 14, 2021, 01:27 UTC
- Message-ID
- <xmqq5yyh1bhl.fsf@gitster.g>
- In-Reply-To
- <87k0my1bgp.fsf@evledraar.gmail.com>
Ævar Arnfjörð Bjarmason <avarab@gmail.com> writes:
Show 36 quoted lines
> 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.
Looks good to me. I am tempted to suggest that we should take this as "fix to the documentation proper". We can discuss the policy and guideline separately.