@DerekRoth please note that I really appreciate that you take the time do fix the docs. That's really lovely.

However, this can be done a bit better. Instead of using `.. code-block:: php`, you can also end the last sentence before the code block with a double colon: `::`. This will highlight the comming code block as a PHP code block (since it's the default language on symfony.com) and it'll replace it with a single colon, so that everything renders as expected.

So if you can change it to this, I'll be very happy, otherwise this is fine too :)

````rst
edit a particular object. Here's an example implementation::

    // src/Acme/DemoBundle/Security/Authorization/Voter/PostVoter.php
````

Diff:
````diff
-edit a particular object. Here's an example implementation:
+edit a particular object. Here's an example implementation::
-
-.. code-block:: php
````