Implemented the changes suggested by reviewers

javiereguiluz · javiereguiluz · commit c0637b6bd793 · 2015-05-29T09:21:18.000+02:00
diff --git a/cookbook/bundles/best_practices.rst b/cookbook/bundles/best_practices.rst
@@ -303,6 +303,12 @@ following standardized instructions in your ``README.md`` file.
 
         .. _`installation chapter`: https://getcomposer.org/doc/00-intro.md
 
+The example above assumes that you are installing the latest stable version of
+the bundle, where you don't have to provide the package version number
+(e.g. ``composer require friendsofsymfony/user-bundle``). If the installation
+instructions refer to some past bundle version or to some inestable version,
+include the version constraint (e.g. ``composer require friendsofsymfony/user-bundle "~2.0@dev"``).
+
 Optionally, you can add more installation steps (*Step 3*, *Step 4*, etc.) to
 explain other required installation tasks, such as registering routes or
 dumping assets.
diff --git a/cookbook/bundles/installation.rst b/cookbook/bundles/installation.rst
@@ -63,7 +63,7 @@ The only thing you need to do now is register the bundle in ``AppKernel``::
         public function registerBundles()
         {
             $bundles = array(
-                // ...,
+                // ...
                 new FOS\UserBundle\FOSUserBundle(),
             );
 
@@ -73,8 +73,9 @@ The only thing you need to do now is register the bundle in ``AppKernel``::
 
 By default, Symfony bundles are registered in all the application
 :doc:`execution environments </cookbook/configuration/environments>`. If the bundle
-is meant to be used only in the development or test environments, register it in
-the section below::
+is meant to be used only in some environment, register it within an ``if`` statement,
+like the following example, where the FOSUserBundle is only enabled for the
+``dev`` and ``test`` environments::
 
     // app/AppKernel.php
 
@@ -86,7 +87,7 @@ the section below::
         public function registerBundles()
         {
             $bundles = array(
-                // ...,
+                // ...
             );
 
             if (in_array($this->getEnvironment(), array('dev', 'test'))) {
