From c0a2daad78c66def2ce6592977b78dab6475dd53 Mon Sep 17 00:00:00 2001 From: Alex Gaynor Date: Fri, 29 Nov 2013 18:39:19 -0600 Subject: [PATCH] Documented the house style for gender neutral pronouns. --- .../contributing/writing-documentation.txt | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/internals/contributing/writing-documentation.txt b/docs/internals/contributing/writing-documentation.txt index e565b4d54f7..ba53a1a3d61 100644 --- a/docs/internals/contributing/writing-documentation.txt +++ b/docs/internals/contributing/writing-documentation.txt @@ -65,6 +65,19 @@ Primer `. After that, you'll want to read about the :ref:`Sphinx-specific markup ` that's used to manage metadata, indexing, and cross-references. +Writing style +------------- + +When using pronouns in reference to a hypothetical person, such as "a user with +a session cookie", gender neutral pronouns (they/their/them) should be used. +Instead of: + +* he or she... use they. +* him or her... use them. +* his or her... use their. +* his or hers... use theirs. +* himself or herself... use themselves. + Commonly used terms -------------------