mirror of https://github.com/CrimsonTome/tldr.git
GOVERNANCE.md, CONTRIBUTING.md: add inclusive language blurb (#4516)
parent
d26f0c9907
commit
0c9f1209d1
|
@ -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.
|
||||||
|
|
|
@ -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
|
||||||
|
|
Loading…
Reference in New Issue