Skip to content

Commit 8f94556

Browse files
authored
Merge pull request #2383 from erikvanoosten/patch-1
Avoid dysphemisms
2 parents 95133b1 + 7930c37 commit 8f94556

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

_overviews/contribute/inclusive-language-guide.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,7 @@ This list is neither comprehensive nor definitive, and it can evolve over time.
9090
* **blacklist/whitelist** \
9191
While the etymology of these words has no relation to racism, their use suggests an association between the color black and some form of badness or exclusion, and between the color white and some form of goodness or inclusion.
9292
Prefer alternatives when possible.
93-
Several alternatives have been proposed but none sticks as "the one". We suggest using the pair *excludelist*/*includelist*, as it is generic enough to replace all uses of *blacklist*/*whitelist*.
93+
Several alternatives have been proposed but none sticks as "the one". We suggest using the pair *denylist*/*allowlist* or the pair *excludelist*/*includelist*, as these are generic enough to replace most uses of *blacklist*/*whitelist*.
9494
* **master/slave** \
9595
Never use *slave*.
9696
Never use *master* in conjunction with *slave*.
@@ -116,6 +116,12 @@ We encourage you to research inclusive language guidelines applicable to your do
116116

117117
You may want to use automated software like [In Solidarity](https://github.com/apps/in-solidarity) to steer contributors away from loaded words.
118118

119+
## Dysphemism
120+
121+
Dysphemisms, the opposite of euphemisms, can be disturbingly violent if you are not used to them.
122+
Examples include the English expressions "pull the trigger" (enforce a decision) and "bite the bullet" (endure hardship).
123+
Prefer the direct meaning instead.
124+
119125
## Backward compatibility
120126

121127
Sometimes, we have existing code, APIs or commands that do not follow the above recommendations.

0 commit comments

Comments
 (0)