symfony/symfony-docs — pull request #1798 by WouterJ (2012-10-08 16:04:45+00:00)
Title: [book] Fixed every inconsistention find in quick proofread

I did a quick proofread of the book articles today and fixed every inconsistentie or error I found.

I'm in doubt of 2 things:

### Linenumbers

In the past, we added `:linenos:` as the first line on a code-block to get linenumbers. Since a couple months Symfony has a new style for code blocks, including linenumbers on every code block. This means the `:linenos:` is completely ingored. I think it's better to remove the `:linenos:` from the code blocks, or is there a good reason to keep them?

### Text or urls

Sometimes we want to show a text result, headers or a url. This is done in 2 ways in the docs:

URLs are formatted in the following way:

.. code-block:: text

http://localhost/app.php/hello/Ryan

or

URLs are formatted in the following way:

http://localhost/app.php/hello/Ryan

The first option creates a normal code-block, as you can see on [the page creation article](http://symfony.com/doc/master/book/page_creation.html#environments) and the second option created a quote block, as you can see on [the security article]http://symfony.com/doc/master/book/security.html#impersonating-a-user).

Both have pros and cons:

* A code block doesn't show links as clickable anchors
* A quote block doesn't show linenumbers
* A quote block is more semantic

Which option do we use over the docs? For what I have seen today the first option is used more than the second option.