From b6e0ba0fb7bf0eccdcf84c730ea23bb4544f427d Mon Sep 17 00:00:00 2001 From: Gabriel Orisaka Date: Tue, 2 Aug 2016 23:25:49 -0300 Subject: Add recommendation about terminology (#3079) --- docs/development/submitting-patches.rst | 5 +++++ 1 file changed, 5 insertions(+) (limited to 'docs/development') diff --git a/docs/development/submitting-patches.rst b/docs/development/submitting-patches.rst index 475e7037..63eed19d 100644 --- a/docs/development/submitting-patches.rst +++ b/docs/development/submitting-patches.rst @@ -126,6 +126,11 @@ should begin with the "Hazardous Materials" warning: .. hazmat:: +Always prefer terminology that is most broadly accepted. For example: + +* When referring to class instances use "an instance of ``Foo``" + instead of "a ``Foo`` provider". + When referring to a hypothetical individual (such as "a person receiving an encrypted message") use gender neutral pronouns (they/them/their). -- cgit v1.2.3