Permalink
Browse files

Documented the house style for gender neutral pronouns.

  • Loading branch information...
alex authored and timgraham committed Nov 30, 2013
1 parent ec73ce5 commit c0a2daad78c66def2ce6592977b78dab6475dd53
Showing with 13 additions and 0 deletions.
  1. +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
-------------------

3 comments on commit c0a2daa

@guilleiguaran

This comment has been minimized.

Show comment Hide comment
@guilleiguaran

guilleiguaran Dec 2, 2013

@alex I hope you do not mind that I copied this 😄

rails/rails@6f0fb7b

@alex I hope you do not mind that I copied this 😄

rails/rails@6f0fb7b

@alex

This comment has been minimized.

Show comment Hide comment
@alex

alex Dec 2, 2013

Member

Absolutely not, spread it far and wide!

Member

alex replied Dec 2, 2013

Absolutely not, spread it far and wide!

@weaverryan

This comment has been minimized.

Show comment Hide comment
@weaverryan

weaverryan Dec 3, 2013

And us too symfony/symfony-docs#3270 :) - thanks guys!

And us too symfony/symfony-docs#3270 :) - thanks guys!

Please sign in to comment.