Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

Documented the house style for gender neutral pronouns.

  • Loading branch information...
commit c0a2daad78c66def2ce6592977b78dab6475dd53 1 parent ec73ce5
Alex Gaynor authored November 29, 2013 timgraham committed November 30, 2013
13  docs/internals/contributing/writing-documentation.txt
@@ -65,6 +65,19 @@ Primer <sphinx:rst-primer>`. After that, you'll want to read about the
65 65
 :ref:`Sphinx-specific markup <sphinx:sphinxmarkup>` that's used to manage
66 66
 metadata, indexing, and cross-references.
67 67
 
  68
+Writing style
  69
+-------------
  70
+
  71
+When using pronouns in reference to a hypothetical person, such as "a user with
  72
+a session cookie", gender neutral pronouns (they/their/them) should be used.
  73
+Instead of:
  74
+
  75
+* he or she... use they.
  76
+* him or her... use them.
  77
+* his or her... use their.
  78
+* his or hers... use theirs.
  79
+* himself or herself... use themselves.
  80
+
68 81
 Commonly used terms
69 82
 -------------------
70 83
 

3 notes on commit c0a2daa

Guillermo Iguaran

@alex I hope you do not mind that I copied this :smile:

rails/rails@6f0fb7b

Alex Gaynor
Owner

Absolutely not, spread it far and wide!

Ryan Weaver

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

Please sign in to comment.
Something went wrong with that request. Please try again.