[symfony#3149] Tweaking language to use a standard for capitalization

weaverryan · weaverryan · commit 40241af8fd6b · 2013-11-09T12:46:30.000-05:00
diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
@@ -106,12 +106,14 @@ Example
 Language Standards
 ------------------
 
-* Capitalize the first letter of any heading and the first letter of all
-  nouns and adjectives afterwards (verbs are lowercase);
+* For sections, use the following rule for capitalization:
+  `Capitalization of the first word, and all other words, except for closed-class words`_:
+    The Vitamins are in my Fresh California Raisins
 * Do not use `Serial (Oxford) Commas`_;
 * You should use a form of *you* instead of *we* (i.e. avoid the first person
   point of view: use the second instead).
 
 .. _`the Sphinx documentation`: http://sphinx-doc.org/rest.html#source-code
 .. _`Twig Coding Standards`: http://twig.sensiolabs.org/doc/coding_standards.html
+.. _`Capitalization of the first word, and all other words, except for closed-class words`: http://en.wikipedia.org/wiki/Letter_case#Headings_and_publication_titles
 .. _`Serial (Oxford) Commas`: http://en.wikipedia.org/wiki/Serial_comma
