Ævar Arnfjörð Bjarmason <avarab@xxxxxxxxx> writes: > 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@xxxxxxxxx/ >> [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@xxxxxxxxxxxxxxxxxxx/ >> >> 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.
