Skip to content

Commit c4c0be1

Browse files
Avoid dysphemisms
I was reading the inclusive language guide at https://docs.scala-lang.org/contribute/inclusive-language-guide.html. I have 2 points of feedback. I initially posted this on Discord but then I noticed I could do a pull request. So here it is. Re. blacklist/whitelist. Such lists are often used to regulate access. Therefore I propose we suggest the alternative 'allowlist/denylist' as it is probably appropriate in more circumstances. This is also the suggestion done from the linked page https://github.com/dialpad/inclusive-language.
1 parent 4e48e55 commit c4c0be1

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 *allowlist*/*denylist*, as it is 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, should be avoided. For example, the English expressions "pull the trigger" (enforce a decision) and "bite the bullet" (endure hardship) can be disturbingly violent if you are not used to them.
122+
123+
Using the direct meaning is preferred.
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)