Skip to content

Inclusive language guide as developed by Dialpad linguists

License

Notifications You must be signed in to change notification settings

dialpad/inclusive-language

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Inclusive Language at Dialpad

The language we use is a simple but tiny corner of being inclusive of all employees, and we recognize that there is still terminology in the tech industry and at our company that has problematic origins or connotations. Every employee has the right to work in an environment where they are respected, included and valued. This document provides a list of recommendations for inclusive language, based on research by the linguists of Dialpad.

Internal discussion of inclusive language has resulted in the creation of this document. It seeks to provide concrete actions to encourage company-wide and context-independent use of language that includes everyone. That being said, this is a living document that will always need multiple perspectives to achieve its goals. Please bring up your thoughts or concerns about this document with any manager; we welcome every contribution.

The terminology in question falls broadly into two categories; technical vs day-to-day language. The former involves terms that may or do currently show up directly in code or in technical documentation; the latter includes terms that arise in everyday speech, and might result in some listeners feeling excluded. Both sections are relevant to engineering teams but other non-engineering teams will be most interested in the second section. Following the list of suggested replacements, we discuss the use of these recommendations going forward. At the end of the document we've included an appendix expanding on the reasons for which particular terms have been considered for replacement.

Term Recommended alternative Read more here
"whitelist" allowlist "Bad is Black" effect
"blacklist" denylist "Bad is Black" effect
"master" (git repository) main "Master/slave" terminology
"master/slave" (nodes) coordinator/worker "Master/slave" terminology
"master/slave" (databases) primary/replica "Master/slave" terminology
"ghetto test" smoke test Etymology of "ghetto"
"dummy value" placeholder Ableist language
"sanity check" confidence check Ableist language
"male/female connectors" plug/socket On sex and gender
"mother/daughter nodes" parent/child nodes On sex and gender
"sister nodes" sibling nodes On sex and gender
"mom test" / "girlfriend test" / "granny test" user testing On sex and gender, Ageism in tech
"black / white hat hacking" ethical/unethical hacking "Bad is Black" effect
"dead man's switch" death switch On sex and gender
Term Recommended alternative Read more here
(generic) "she" / "he" they On sex and gender
(generic) "her" / "him" / "him or her" / "him/her" their On sex and gender
(generic) "hers" / "his" / "his or her" / "his/her" / "his/hers" theirs On sex and gender
"mankind" people / humankind / society On sex and gender
"manpower" effort On sex and gender
"man-hours" hours of effort / person-hours On sex and gender
"man-months" months of effort / person-months On sex and gender
"grandfathered" / "grandfather clause" legacy status The history of "grandfathering"
"ghetto share" double screenshare Etymology of "ghetto"
"middle man" intermediary On sex and gender

Our goal is to switch to inclusive language at our company at every level - in our daily conversations with teammates and customers, our user-facing documentation, our internal technical documentation and our code. Additions to any of these areas must avoid the non-inclusive language in this guide, and any older code or documentation should be updated as soon as is feasible.

All new code that goes into our codebase must avoid the non-inclusive language in this guide.

Please feel empowered to fix any non-inclusive language that exists in our codebase. The management team is working to do this, but please fix or call out anything that continues to exist.

Some code might be hard to fix right away (such as database model names). When that happens please open a ticket to track it, and leave a comment on the code so we can identify these easily, e.g., "TODO(inclusivity): #TicketNumber your comment here"

"Blacklist/whitelist" and "black/white hat hackers" play into the metaphor of black = bad and white = good. Research has found that this type of metaphor contributes to implicit bias so it is good to avoid. Additionally, "allow" and "deny" are more transparent in meaning than "black" and "white".

"They/them/theirs" has been used as a 3rd person singular pronoun when the gender of the person is unknown or explicitly unspecified since the 15th century AD. Despite what self-styled grammar mavens may tell you, we linguists give you full permission to use these pronouns everywhere when you are talking about a generic user or developer, to be inclusive of everyone. Please refer to On sex and gender for more information on gender.

It is important to remember, though, that when referring to specific individuals, inclusive practice is to use the pronouns they have asked you to use to refer to them! For example, if Vasundhara uses xe/xem/xyr and they/them/their pronouns, you should say, "Xe loves birds," or "They wrote a song about trilobites."

Moving away from language that centres men signals inclusion of all genders. There are many good alternatives that refer to a generic person without the connotation that maleness is the "default" gender. Please ensure that you use gender-inclusive language in code, technical documentation and user-facing documentation like our website and support pages.

Anatomical sex, gender (identity), gender expression and sexuality are distinct concepts that often get confused or conflated. Refer to the Gender Unicorn for a quick summary of the concepts. Pronouns are a form of gender expression which is not directly predictable from someone's gender (e.g., a woman who uses they/them pronouns) or their appearance. Read more in this IBM blog post about pronouns and in this blog post about pronouns by nonbinary linguist Dr. Kirby Conrod.

"Male" and "female" connectors are needlessly related to anatomical sex (genitalia). It's unclear that this terminology should be in the workplace and we can do better with the alternative "plug" and "socket".

"Master/slave" terminology in tech alludes to the horrific practice of slavery. Especially in the North America, the history of slavery is very recent, very racialized and thus a source of pain to Black people. Many Black developers have asked for the change to be made because they find the term personally offensive and many non-Black developers also find the term inappropriate (see final paragraph of this section). This is not a new thing - people have been against this terminology for decades; see for example this news article about "master/slave" terminology from 2003.

You may be surprised to learn that the "master" branch in the version control software git comes from the "master/slave" concept, and not from master copy. In light of this problematic and painful history, it's a good idea to move away from this terminology.

In the context of nodes, we want to differentiate between special nodes that tell other nodes what to do (the "special" node can create more worker nodes, take them down when unused, distribute work between them, etc.).

In the context of databases, on the other hand, we want to differentiate between the main database and several copies of it - "primary/replica" communicates this transparently. Note that some systems have already made the decision to implement alternate terminology which constrains us to use the commands they provide. For example, Redis chose "master/replica" terminology and this is reflected in their commands.

This qualitative tweet thread sparked by Microsoft senior software engineer Kat Marchán about the "master" branch name in Git, has many interesting responses from Black developers in industry. Most of their responses say that they support the change. One Black developer even said, "The combination of master/slave is highly problematic and I feel something really negative and triggering every time someone uses those phrases in my presence." While some people may not be personally offended by the terminology, it is useful to consider the difference between offense and harm.

The term "ghetto" has particularly racist connotations against Black people in the US, where many of our employees live and work. It originally meant a part of the city where minority groups lived, then it was used to describe walled-off places where Jewish people were kept in Nazi Germany. But the US's much more recent history of segregation has changed the meaning. When used as an adjective, it is used to convey "unruly" or "uncouth" behaviour, and given the inextricable link to segregation and US history, this perpetuates problematic ideas that stigmatize Black people.

Ableism, discrimination and prejudice against disabled people, is pervasive in our society and the language we use is a part of the bigger problem of "systematically devaluing bodies and minds that are deemed deviant, abnormal or defective," according to disability activist Lydia X. Z. Brown. Her website includes a detailed discussion of ableist language and alternatives for a general audience.

"Dummy" has an offensive (but dated) connotation towards people who are dumb (cannot speak). More broadly, conflating mental illness with "bad" or "less" is ableist. The suggested alternatives do not perpetuate ableism, and are also more accurate.

The idea behind user testing is to get users unfamiliar with the product to test it and give you feedback. "User testing" communicates that idea without perpetuating sexist and ageist ideas about who can use our applications, compared to "granny testing".

Assuming that older people cannot use technology or cannot use our application is harmful because it reinforces tech's existing problem of ageism. This is a form of bias against older people that is not often talked about in tech but has been quantified - there is an age-linked salary ceiling and barriers to entry and retention.

The term "grandfather clause" comes from the US and slavery - it was a clause in the US constitution to prevent Black people from voting. This is a case where in addition to the original term having problematic origins, we should make this change also because the alternative "legacy status" is clearer in meaning.