From 0c9f1209d1e7192b76d992d7f947e76d190b6ed9 Mon Sep 17 00:00:00 2001 From: Quinn Vissak Date: Tue, 3 Nov 2020 14:12:50 -0500 Subject: [PATCH] GOVERNANCE.md, CONTRIBUTING.md: add inclusive language blurb (#4516) --- CONTRIBUTING.md | 5 +++++ GOVERNANCE.md | 3 +++ 2 files changed, 8 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index f1f0f774c..df3f3913f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -105,6 +105,11 @@ Some examples of valid locale tags: The default language used for pages is English (US). Pages written in English are stored in the default `pages` directory (notice the absence of a specific language tag). Although not strictly required, if you'd like to add a new page in a different language, please consider creating the English page too. +## Inclusive language + +Where possible, use inclusive language in the content of pages. For example, prefer terms like "denylist"/"allowlist" instead of "blacklist"/"whitelist", "primary"/"secondary" instead of "master"/"slave", "they" instead of "him"/"her", etc. +Of course, this shouldn't sacrifice content clarity, such as when documenting tools where this terminology has specific technical meanings, and its usage is central to explaining the involved concepts. + ## Submitting a pull request The easiest way to submit a change is to just edit the page directly on the GitHub interface. diff --git a/GOVERNANCE.md b/GOVERNANCE.md index e4c14bbd1..6a4728ee7 100644 --- a/GOVERNANCE.md +++ b/GOVERNANCE.md @@ -27,6 +27,9 @@ Community members are asked to abide by the following principles: Remember, it's very hard to convey meaning on a purely written medium, especially between people from different cultures, technical backgrounds, English proficiency levels, etc. + Use inclusive language whenever possible and reasonable — for example, + [avoid assuming gender](https://en.wikipedia.org/wiki/Singular_they), and + refrain from racially or ethnically charged terms. 3. **All communications are public**. There are no permanent private channels