From 22f885bbc8258e2b721e442877fe38be806cc92d Mon Sep 17 00:00:00 2001 From: Stan Ulbrych Date: Sat, 20 Dec 2025 19:12:03 +0000 Subject: [PATCH 1/2] Add section on discouraged terminology --- documentation/style-guide.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/documentation/style-guide.rst b/documentation/style-guide.rst index d90a14ce9..f42aa516c 100644 --- a/documentation/style-guide.rst +++ b/documentation/style-guide.rst @@ -116,6 +116,25 @@ Don't use Latin abbreviations like "e.g." or "i.e." where English words will do, such as "for example" or "that is." +Charged terminology to avoid +============================ + +Avoid terminology that may be considered insensitive or exclusionary. + +.. list-table:: + :header-rows: 1 + + * - Avoid + - Instead + * - whitelist + - allowlist + * - blacklist + - blocklist, denylist + * - master/slave + - main, parent/child, server/client, primary/secondary + + + .. index:: diataxis .. _diataxis: From 239c71270dda34967385678c51ddc3955b2b2e0a Mon Sep 17 00:00:00 2001 From: Stan Ulbrych Date: Sat, 20 Dec 2025 19:14:01 +0000 Subject: [PATCH 2/2] Additional line --- documentation/style-guide.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/documentation/style-guide.rst b/documentation/style-guide.rst index f42aa516c..d263fb8f1 100644 --- a/documentation/style-guide.rst +++ b/documentation/style-guide.rst @@ -134,7 +134,6 @@ Avoid terminology that may be considered insensitive or exclusionary. - main, parent/child, server/client, primary/secondary - .. index:: diataxis .. _diataxis: