On Wednesday, 9 November 2022 at 14:01:38 UTC, Quirin Schroll wrote:
>I forgot that Iāve seen DIP drafts that used her pronouns to refer to an abstract programmer. Iād consider that overtly politically motivated. My personal taste is not even deciding between generic he and the recently emerging, yet disputed among linguists, āsingularā they and just go with they and use the plural programmers.
Using "he", "she" or "they" in a technical paper without referring what that means is an error, similar to a dangling motivator error. You can use "the raccoon" if you want to but you must explain what that means in the text. Using "the user" might also need a clarification, like the end user/customer of a particular library. In legal documents this is even more important in order to avoid ambiguities.
In my opinion, using he/she/they in technical documentations should be avoided as far as possible and it also looks amateurish.