Skip to content

Commit 22f885b

Browse files
Add section on discouraged terminology
1 parent 1830ddd commit 22f885b

File tree

1 file changed

+19
-0
lines changed

1 file changed

+19
-0
lines changed

documentation/style-guide.rst

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -116,6 +116,25 @@ Don't use Latin abbreviations like "e.g." or "i.e." where English words will do,
116116
such as "for example" or "that is."
117117

118118

119+
Charged terminology to avoid
120+
============================
121+
122+
Avoid terminology that may be considered insensitive or exclusionary.
123+
124+
.. list-table::
125+
:header-rows: 1
126+
127+
* - Avoid
128+
- Instead
129+
* - whitelist
130+
- allowlist
131+
* - blacklist
132+
- blocklist, denylist
133+
* - master/slave
134+
- main, parent/child, server/client, primary/secondary
135+
136+
137+
119138
.. index:: diataxis
120139
.. _diataxis:
121140

0 commit comments

Comments
 (0)