Skip to content

Avoid dysphemisms #2383

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
May 17, 2022
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 7 additions & 1 deletion _overviews/contribute/inclusive-language-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,7 @@ This list is neither comprehensive nor definitive, and it can evolve over time.
* **blacklist/whitelist** \
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.
Prefer alternatives when possible.
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*.
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*.
* **master/slave** \
Never use *slave*.
Never use *master* in conjunction with *slave*.
Expand All @@ -116,6 +116,12 @@ We encourage you to research inclusive language guidelines applicable to your do

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

## Dysphemism

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.

Using the direct meaning is preferred.

## Backward compatibility

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