GOVERNANCE.md, CONTRIBUTING.md: add inclusive language blurb (#4516)

translation-badges
Quinn Vissak 2020-11-03 14:12:50 -05:00 committed by GitHub
parent d26f0c9907
commit 0c9f1209d1
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 8 additions and 0 deletions

View File

@ -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. 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 ## Submitting a pull request
The easiest way to submit a change is to just edit the page directly on the GitHub interface. The easiest way to submit a change is to just edit the page directly on the GitHub interface.

View File

@ -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, Remember, it's very hard to convey meaning on a purely written medium,
especially between people from different cultures, technical backgrounds, especially between people from different cultures, technical backgrounds,
English proficiency levels, etc. 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**. 3. **All communications are public**.
There are no permanent private channels There are no permanent private channels