Tweaking spacing, markup for #1597

Author: weaverryan

contributing/documentation/overview.rst

@@ -71,28 +71,30 @@ GitHub covers the topic of `pull requests`_ in detail.
 Standards
 ---------
 
-In order to help the reader as much as possible and to create code examples that 
-looks and feels familiar, you should follow these rules:
+In order to help the reader as much as possible and to create code examples that
+look and feel familiar, you should follow these rules:
 
-* The code follows the Coding Standards, the :doc:`Symfony Coding Standards</contributing/code/standards>` 
+* The code follows the :doc:`Symfony Coding Standards</contributing/code/standards>`
   as well as the `Twig Coding Standards`_;
-* When we fold one or more lines of code, we place `...` in a comment at the point 
-  of the fold. These comments are: `// ...` (php), `# ...` (yaml/bash), `{# ... #}` 
-  (twig), `<!-- ... -->` (xml/html), `; ...` (ini), `...` (text);
-* When we fold a part of a line, e.g. a variable value, we put `...` (without comment)
+* When we fold one or more lines of code, we place ``...`` in a comment at the point
+  of the fold. These comments are: ``// ...`` (php), ``# ...`` (yaml/bash), ``{# ... #}``
+  (twig), ``<!-- ... -->`` (xml/html), ``; ...`` (ini), ``...`` (text);
+* When we fold a part of a line, e.g. a variable value, we put ``...`` (without comment)
   at the place of the fold;
-* Description about the fold: (optional)
-  If we fold some lines: The description can be placed after the `...`
-  If we fold a part of a line: The description can be placed before the line;
-* If usefull, a codeblock begins with a comment with the filename. After this comment 
-  should not be a blank line, except if the next line is a comment too;
-* You should put a `$` in front of every bash line;
-* We prefer the `::` shorthand over `.. code-block:: php` to begin a PHP code block.
+* Description of the foloed code: (optional)
+  If we fold several lines: the description of the fold can be placed after the ``...``
+  If we fold only part of a line: the description can be placed before the line;
+* If useful, a ``codeblock`` should begin with a comment containing the filename
+  of the file in the code block. Place a blank line after this comment,
+  unless the next line is also a comment;
+* You should put a ``$`` in front of every bash line;
+* We prefer the ``::`` shorthand over ``.. code-block:: php`` to begin a PHP
+  code block.
 
 An example::
 
     // src/Foo/Bar/foo.php
-    function foo($bar) 
+    public function foo($bar)
     {
         // set foo with a value of bar
         $foo = ...;
@@ -103,10 +105,11 @@ An example::
     }
 
 .. note::
-    * In Yaml you should to put a space after `{` and before `}` (e.g. `{ _controller: ... }`), 
-      but this should not be done in Twig (e.g. `{'hello' : 'value'}`).
-    * An array item is a part of a line, not a complete line. So you should not use `// ...` 
-      but `...,` (the comma because of the Coding Standards)::
+
+    * In Yaml you should put a space after ``{`` and before ``}`` (e.g. ``{ _controller: ... }``),
+      but this should not be done in Twig (e.g. ``{'hello' : 'value'}``).
+    * An array item is a part of a line, not a complete line. So you should
+      not use ``// ...`` but ``...,`` (the comma because of the Coding Standards)::
 
         array(
             'some value',