[#1693] Minor tweaks

Author: weaverryan

cookbook/console/usage.rst

@@ -6,21 +6,26 @@ How to use the Console
 
 The :doc:`/components/console/usage` page of the components documentation looks
 at the global console options. When you use the console as part of the full
-stack framework some additional global options are available as well.
+stack framework, some additional global options are available as well.
 
-By default console commands run in the ``dev`` environment, you may want
+By default, console commands run in the ``dev`` environment and you may want
 to change this for some commands. For example, you may want to run some commands
-in the ``prod`` environment for performance reasons. The result of some commands
-will be different depending on the environment, for example, the ``cache:clear``
-command will clear and warm the cache for the specified environment only so to
+in the ``prod`` environment for performance reasons. Also, the result of some commands
+will be different depending on the environment. for example, the ``cache:clear``
+command will clear and warm the cache for the specified environment only. To
 clear and warm the ``prod`` cache you need to run:
 
 .. code-block:: bash
 
     $ php app/console cache:clear --env=prod
+
+or the equivalent:
+
+.. code-block:: bash
+
     $ php app/console cache:clear -e=prod
 
-As well as changing the environment you can also choose to disable debug mode.
+In addition to changing the environment, you can also choose to disable debug mode.
 This can be useful where you want to run commands in the ``dev`` environment
 but avoid the performance hit of collecting debug data:
 
@@ -50,11 +55,11 @@ When using the shell you can choose to run each command in a separate process:
     $ php app/console --shell --process-isolation
     $ php app/console -s --process-isolation
 
-When you do this the output will not be colorized and interactivity is not
+When you do this, the output will not be colorized and interactivity is not
 supported so you will need to pass all command params explicitly.
 
 .. note::
 
     Unless you are using isolated processes, clearing the cache in the shell
     will not have an effect on subsequent commands you run. This is because
-    the original cached files will still be being used.
+    the original cached files are still being used.

cookbook/map.rst.inc

@@ -27,6 +27,7 @@
 * **Console Commands**
 
   * :doc:`/cookbook/console/console_command`
+  * :doc:`/cookbook/console/usage`
 
 * :doc:`/cookbook/controller/index`