Browse Source

Documented the house style for gender neutral pronouns.

Alex Gaynor 11 năm trước cách đây
mục cha
commit
c0a2daad78
1 tập tin đã thay đổi với 13 bổ sung0 xóa
  1. 13 0
      docs/internals/contributing/writing-documentation.txt

+ 13 - 0
docs/internals/contributing/writing-documentation.txt

@@ -65,6 +65,19 @@ Primer <sphinx:rst-primer>`. After that, you'll want to read about the
 :ref:`Sphinx-specific markup <sphinx:sphinxmarkup>` 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
 -------------------