Skip to content
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

adding inclusive language standards to the README #2446

Merged
merged 4 commits into from
Feb 28, 2023
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
Prev Previous commit
Next Next commit
changes after talking to DEI
Lavanya Singh committed Nov 16, 2022
commit 4aa02e3ab0cd683bf957e272b53b529e5ae16005
14 changes: 7 additions & 7 deletions docs/best-practices/java-coding-guidelines/inclusive_code.md
Original file line number Diff line number Diff line change
@@ -7,12 +7,12 @@ code to be written with inclusivity in mind. In particular, we try to avoid phra
The list of phrases contains two types of expressions: gendered or exclusive terms and everyday phrases with racist origins.
This list was developed by our Diversity, Equity, and Inclusion team.

| Term | Suggested Replacements |
|--------------------| ---------------------- |
| Able-bodied | Reinforces dominant norms about physical ability. Suggested alternative: non-disabled. |
| Blackout | "We want to blackout these three dates to allow for a migration to take place. You won’t be able to access the site." This could insinuate that black means "bad"or something negative. Suggested alternatives: Block out, Downtime, Maintenance window |
| Blacklist/whitelist | These phrases may insinuate black means bad and white means good. Suggested alternatives: blocklist/denylist and allowlist
| Blind/deaf to | Avoid phrases that associate impairments with negative connotations.
| Term | Suggested Replacements |
|------------------| ---------------------- |
| Able-bodied | Reinforces dominant norms about physical ability. Suggested alternative: non-disabled. |
| Blackout | "We want to blackout these three dates to allow for a migration to take place. You won’t be able to access the site." This could insinuate that black means "bad"or something negative. Suggested alternatives: Block out, Downtime, Maintenance window |
| Blacklist/whitelist | These phrases may insinuate black means bad and white means good. Suggested alternatives: blocklist/denylist/banlist and allowlist
| Blind/deaf to | Avoid phrases that associate impairments with negative connotations.
| Dummy value/text | Although in this context you may not be referring to a person, the phrase reinforces stereotypes that bodies and minds are defective or less than and that typical abilities are superior. Suggested alternatives: Placeholder, sample or filler.
| Girl/Girls (when referring to women) | Referring to women over 18 years old as a girl has a diminishing effect. Defined by the National Council of Teachers of English as gender-biased, the use of girl in professional contexts has been found to trivialize and patronize women. Instead: Woman or women is a better choice.
| Grandfathering/grandfather clause | A way to exempt some people from a change because of conditions that existed before the change (e.g. we’ve grandfathered some users on an unlimited data plan.”) The term “grandfather clause” originated in the American South in the 1890s as a way to defy the 15th Amendment and prevent black Americans from voting. A good alternative might be “legacy” or "covered under a previous program."
@@ -21,7 +21,7 @@ This list was developed by our Diversity, Equity, and Inclusion team.
| Handicap | Some disability advocates believe this term is rooted in a correlation between a disabled individual and a beggar, “who had to beg with a cap in his or her hand because of the inability to maintain employment.” Better alternative: Disabled
| Housekeeping | In reference to office work, this language can feel gendered. Suggested alternative: maintenance, cleanup
| Ladies/gals | Terms like “ladies”, “gals” or others can feel patronizing to some. Instead: try women, or “folks” or “people” for mixed-gender groups.
| Master/slave | Problematic term sometimes used to refer to one machine that has the original copy of data and others that automatically update themselves to match its data. Replacements include primary/replica, primary/standby
| Master/slave | Problematic term sometimes used to refer to one machine that has the original copy of data and others that automatically update themselves to match its data. Replacements include primary/replica, primary/standby, main/replica
| Nitty-gritty | This term is often used to refer to the “core” or “heart of a matter,” but it was historically a euphemism for the layer of excrement at the bottom of a slave ship after a Trans-Atlantic crossing.
| Sanity check/test | The phrase sanity check is ableist, and unnecessarily references mental health. It denotes that people with mental illnesses are inferior, wrong, or incorrect. Suggested alternatives: Quick check/test, initial check, confidence check, coherence check, soundness check, calibration check, rationality check