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

Add FAQs from github/conscious-lang-docs #14

Merged
merged 2 commits into from
Nov 13, 2020
Merged
Show file tree
Hide file tree
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
5 changes: 5 additions & 0 deletions config.toml
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,11 @@ type = "heading_font"
# url = "/general-guidance"
# weight = 2

[[menu.main]]
name = "FAQs"
url = "/faqs"
weight = 4

# [[menu.main]]
# name = "Related projects"
# url = "/related-projects"
Expand Down
67 changes: 67 additions & 0 deletions content/faqs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@

---
title: "Frequently asked questions"
---


## What is inclusive naming about?

The software industry sometimes uses certain words, like blacklist, and slave, that may carry a great deal of emotional and historical baggage. We are encouraging projects to choose phrases that clearly communicate the technical meaning, without using metaphors or colloquialisms.
celestehorgan marked this conversation as resolved.
Show resolved Hide resolved

This has the dual purpose of removing problematic terms, and also communicating more clearly, particularly to those who are working in a secondary language.

Our goals are to identify where problematic terms are used, collaborate on replacement terminology, support project contributors in making updates, and report on joint progress.

## Why is this important?

If software is truly meant to be inclusive and a place where anyone can participate, it must be welcoming to all. If words or phrases convey secondary unintended meanings to our audience (or are simply confusing!) we are potentially limiting participation in our projects, which is antithetical to this goal.

## What terms are we recommending you consider?

We have identified the terms "master/slave" and "whitelist/blacklist" to work on because these are considered most visible and problematic across the industry.

Over time, we may recommend consideration of other terms, such as words that reference mental health, gender, physical handicaps, and several other categories. We may also give tips on avoiding colloquialisms that simply don't translate well or prove a barrier to understanding.

## What are the recommended replacement terms?

See the word replacement list for all terms we recommend replacing.
celestehorgan marked this conversation as resolved.
Show resolved Hide resolved

## Oh no! Slippery slope! Newspeak!

We've heard concerns that this initiative
puts us on a slippery slope to Newspeak portrayed in the 1984 dystopia
by George Orwell. This initiative is completely different from Newspeak.
Newspeak involved multiple changes but the most essential were:

* Removing precise words in favor of general words so that it would become difficult to form precise thoughts
* Using the opposite word for the true situation to disguise what's really happening

Everything in the conscious language initiative is *the exact opposite* of that.

For example, "Denylist" is both more precise and more accurate than "blacklist";

"Primary" is both more precise and more accurate than "master" in projects that have made that switch.
celestehorgan marked this conversation as resolved.
Show resolved Hide resolved

The goal of this project is to use more precise words, in order to avoid
unintended connotations that some common words and phrases have. Not
only does this eliminate the hurt caused by those connotations, it also
improves understanding, particularly for people who are reading in a
second language, where those idioms may be confusing.

## How can I educate myself on why these terms are problematic?

Here are some resources on the topic:

* [Welcoming Nomenclature](https://www.youtube.com/watch?v=hZuFeFuazwo) - Community Central presentation by Rich Bowen (Red Hat)
* [Is It Enough To Remove Words With Racist Connotations From Tech Language? Hint: No](https://www.npr.org/2020/07/09/889502179/is-it-enough-to-remove-words-with-racist-connotations-from-tech-language-hint-no) - NPR interview with web developer Caroline Karanja
* [Why is everything white?](https://www.bbc.com/news/av/world-us-canada-52988605/muhammad-ali-why-is-everything-white) (1971) - interview with Muhammed Ali
* [That Word Black (2014)](http://mcwriting11.blogspot.com/2014/06/that-word-black-by-langston-hughes.html) - blog post by Langston Hughes
* [Broken Metaphor: The Master-Slave Analogy in Technical Literature (2007)](https://www.jstor.org/stable/40061475?seq=1) - article in JSTOR, requires free membership to read
* [Terminology, Power and Oppressive Language](https://tools.ietf.org/id/draft-knodel-terminology-00.html) - article with recommendations by Mallory Knodel and Niels ten Oever
* [Why "master" matters](https://twitter.com/mislav/status/1270388510684598272) - A twitter thread.

## How do I get my organization involved?

* Join our [mailing list](https://groups.google.com/g/inclusivenaming) to receive project updates and invitations to community meetings.
* Identify key people in your organization who can represent this effort in an ongoing fashion
* Read our Implementation Guid and other resources to start making effective changes
celestehorgan marked this conversation as resolved.
Show resolved Hide resolved