My feeling is close to Christian's in this regard. Writing docs is usually harder than writing code, especially for for non-native speakers. Similar thing applies to non-native readers of it. Try writing up a piece of PKI description without using "Alice and Bob" and correlated his/her phrases.
While I understand that many society groups been going through various troubles now and in the past, I do believe that changing of vocabulary will simply not fix their issues. To be fair I don't know how to write that to not step on somebody's else sensitive toe. Best, Łukasz On 02.09.2021 20:18, Christian Schneider wrote: > When there is a list of "bad" words and a tool that highlights them then > this is exactly how it feels. > > Christian > > Am Do., 2. Sept. 2021 um 20:05 Uhr schrieb Rich Bowen <rbo...@rcbowen.com>: > >> >> >> On 9/2/21 1:52 PM, Christian Schneider wrote: >>> I do not like this effort. Banning words and pointing them out is the >> wrong >>> way to achieve an inclusive environment. >>> Also I think words like he or she must not be banned. They are neutral >>> words that are totally acceptable in many cases. >>> Avoiding them in most documentation might be fine but having them on a >> bad >>> word list feels extremely wrong to me. >>> >>> In our well meant effort to be woke we sometimes go too far. >> >> You have misunderstood this initiative. Nothing is banned, forbidden, >> struck from the language, or otherwise removed from use. >> >> If you agree that avoiding these words in documentation might be fine, >> then we're on the same page. >> >> Please don't make this into something it's not. Nobody has the >> authority, or even the desire, to forbid you using certain words. This >> tool is only intended to point out places where there *might* be a >> better word choice. >> >> -- >> Rich Bowen - rbo...@rcbowen.com >> @rbowen >> > >