address comments by xabbuh

cookbook/bundles/extension.rst

@@ -92,7 +92,7 @@ The second method has several specific advantages:
 .. seealso::
 
     For other usages of the parameter ``%`` syntax see
-    :doc:`Using Parameters Within A Dependency Injection Class </cookbook/using_parameters_in_dic>`.
+    :doc:`</cookbook/configuration/using_parameters_in_dic>`.
 
 .. index::
    single: Bundle; Extension

cookbook/configuration/front_controllers_and_kernel.rst

@@ -1,5 +1,5 @@
 .. index::
-    single: How front controller, ``AppKernel`` and environments
+    single: How the front controller, ``AppKernel`` and environments
     work together
 
 Understanding how the Front Controller, Kernel and Environments work together

cookbook/configuration/using_parameters_in_dic.rst

@@ -1,11 +1,11 @@
 .. index::
-    single: Using Parameters Within A Dependency Injection Class
+    single: Using Parameters within a Dependency Injection Class
 
-Using Parameters Within A Dependency Injection Class
+Using Parameters within a Dependency Injection Class
 ----------------------------------------------------
 
 You have seen how to use configuration parameters within
-:ref:`Symfony service container <book-service-container-parameters>`.
+:ref:`Symfony service containers <book-service-container-parameters>`.
 There are special cases such as when you want, for instance, to use the
 ``%kernel.debug%`` parameter to make the services in your bundle enter
 debug mode. For this case there is more work to do in order
@@ -146,14 +146,14 @@ And set it in the constructor of ``Configuration`` via the ``Extension`` class::
 
 .. sidebar:: Setting the Default in the Extension
 
-There are some instances of ``%kernel.debug%`` usage within a ``Configurator``
-class in TwigBundle and AsseticBundle, however this is because the default
-parameter value is set by the Extension class. For example in AsseticBundle,
-you can find::
+    There are some instances of ``%kernel.debug%`` usage within a ``Configurator``
+    class in TwigBundle and AsseticBundle, however this is because the default
+    parameter value is set by the Extension class. For example in AsseticBundle,
+    you can find::
 
-    $container->setParameter('assetic.debug', $config['debug']);
+        $container->setParameter('assetic.debug', $config['debug']);
 
-The string ``%kernel.debug%`` passed here as an argument handles the
-interpreting job to the container which in turn does the evaluation.
-Both ways accomplish similar goals. AsseticBundle will not use
-anymore ``%kernel.debug%`` but rather the new ``%assetic.debug%`` parameter.
+    The string ``%kernel.debug%`` passed here as an argument handles the
+    interpreting job to the container which in turn does the evaluation.
+    Both ways accomplish similar goals. AsseticBundle will not use
+    anymore ``%kernel.debug%`` but rather the new ``%assetic.debug%`` parameter.

cookbook/routing/service_container_parameters.rst

@@ -124,4 +124,4 @@ path):
 .. seealso::
 
     For other usages of the parameter ``%`` syntax see
-    :doc:`Using Parameters Within A Dependency Injection Class </cookbook/using_parameters_in_dic>`.
+    :doc:`</cookbook/configuration/using_parameters_in_dic>`.