> Avoid neurodiversity bias. For example, avoid the terms "sanity check" and "sanity test",
This one seems a little much. I've used this term in work writing within the past week (not in official documentation, but I do also write official documentation). I tried to look up what the acceptable alternatives are (since Section 4.6 doesn't specify one for that rule), but it seems most possible alternatives already have other, distinct meanings: https://english.stackexchange.com/questions/282282/near-univ...
I usually use "smoke check/test" or "smell test", but if you have a specific context in mind, maybe I can give you a different alternative phrase I use or two.
Definitely not something I'd force onto others either though.
It's not a hypothetical situation; I know people with chronic mental health conditions who find this usage of the word "sane" specifically hurtful. It's avoidable; use "reasonable" as an adjective and a phrase like "consistency check" as a verb, or a more specific term like "bounds check" if applicable.
Then those people are unreasonable, and need to adjust their outlook. It is neither healthy for them, nor fair to others, to take such great offense at harmless words.
Love seeing that section, hate people who unironically call themselves one of those phrases. I used to know one guy who integrated his karate hobby into his personality as an agile consultant... it was kinda embarrassing.
It seems you have a certain hyperfocus on inclusivity being mentioned, which is a shame; did you engage with the rest of the document with as much effort? Or do you have an agenda and/or an irrational emotional response to mentions of inclusivity?
> Avoid neurodiversity bias. For example, avoid the terms "sanity check" and "sanity test",
This one seems a little much. I've used this term in work writing within the past week (not in official documentation, but I do also write official documentation). I tried to look up what the acceptable alternatives are (since Section 4.6 doesn't specify one for that rule), but it seems most possible alternatives already have other, distinct meanings: https://english.stackexchange.com/questions/282282/near-univ...
I usually use "smoke check/test" or "smell test", but if you have a specific context in mind, maybe I can give you a different alternative phrase I use or two.
Definitely not something I'd force onto others either though.
> "smell test"
There are a lot more people who would fail that test and be offended when pointed out. That group includes some forms of mental illness as well.
1 reply →
Are we just disregarding the differently-abled people who have a diminished sense of smell? /s
It's not a hypothetical situation; I know people with chronic mental health conditions who find this usage of the word "sane" specifically hurtful. It's avoidable; use "reasonable" as an adjective and a phrase like "consistency check" as a verb, or a more specific term like "bounds check" if applicable.
Then those people are unreasonable, and need to adjust their outlook. It is neither healthy for them, nor fair to others, to take such great offense at harmless words.
12 replies →
From that section, I really like:
>"Avoid superlatives in job titles and descriptions, especially problematic terms such as "guru", "ninja", "rockstar", or "evangelist"."
At a past job, it was actually embarrassing to introduce some of my colleagues in meetings as shit like "Data Guru" and "Marketing Guru".
(I'm sure we can skip the 100,000th argument about the rest of the section).
Love seeing that section, hate people who unironically call themselves one of those phrases. I used to know one guy who integrated his karate hobby into his personality as an agile consultant... it was kinda embarrassing.
It seems you have a certain hyperfocus on inclusivity being mentioned, which is a shame; did you engage with the rest of the document with as much effort? Or do you have an agenda and/or an irrational emotional response to mentions of inclusivity?