Skip to content

Commit f657b39

Browse files
Add section on terminology to avoid to style guide (#1715)
Co-authored-by: Hugo van Kemenade <[email protected]>
1 parent 5d02e79 commit f657b39

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

documentation/style-guide.rst

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -116,6 +116,24 @@ 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+
119137
.. index:: diataxis
120138
.. _diataxis:
121139

0 commit comments

Comments
 (0)