[cookbook] Proofread the new apply_to assetic cookbook

Author: weaverryan

cookbook/assetic/apply_to_option.rst

@@ -1,14 +1,10 @@
-How to Apply an Assetic Filter to a Specified File Extension
-============================================================
+How to Apply an Assetic Filter to a Specific File Extension
+===========================================================
 
-One of Assetic's filters compiles CoffeeScript files into JavaScript.
-This offers the advantages of caching the end result so the compilation
-does not run every time whilst also automatically recompiling when ever
-the script changes during development.
-
-Whilst Assetic's ``CoffeeScriptFilter`` will do the work for you it does
-not do the actual compilation, you will still need to install CoffeeScript
-itself along with node.js on which it runs.
+Assetic filters can be applied to individual files, groups of files or even,
+as you'll see here, files that have a specific extension. To show you how
+to handle each option, let's suppose that you want to use Assetic's CoffeeScript
+filter, which compiles CoffeeScript files into Javascript.
 
 The main configuration is just the paths to coffee and node. These default
 respectively to ``/usr/bin/coffee`` and ``/usr/bin/node``:
@@ -46,8 +42,10 @@ respectively to ``/usr/bin/coffee`` and ``/usr/bin/node``:
             ),
         ));
 
+Filter a Single File
+--------------------
 
-You can then serve up CoffeeScript files as JavaScript from within your
+You can now serve up a single CoffeeScript file as JavaScript from within your
 templates:
 
 .. configuration-block::
@@ -68,9 +66,13 @@ templates:
         <script src="<?php echo $view->escape($url) ?>" type="text/javascript"></script>
         <?php endforeach; ?>
 
+This is all that's needed to compile this CoffeeScript file and server it
+as the compiled JavaScript.
+
+Filter Multiple Files
+---------------------
 
-This is all was needed and the file was served up as regular JavaScript.
-You can combine multiple CoffeeScript files into a single output file:
+You can also combine multiple CoffeeScript files into a single output file:
 
 .. configuration-block::
 
@@ -92,19 +94,21 @@ You can combine multiple CoffeeScript files into a single output file:
         <script src="<?php echo $view->escape($url) ?>" type="text/javascript"></script>
         <?php endforeach; ?>
 
-
 Both the files will now be served up as a single file compiled into regular
 JavaScript.
 
+Filtering based on a File Extension
+-----------------------------------
+
 One of the great advantages of using Assetic is reducing the number of asset
-files to lower ``HTTP`` requests. In order to make full use of this it would
-be good to combine all your JavaScript and CoffeeScript files together
+files to lower HTTP requests. In order to make full use of this, it would
+be good to combine *all* your JavaScript and CoffeeScript files together
 since they will ultimately all be served as JavaScript. Unfortunately just
 adding the JavaScript files to the files to be combined as above will not
 work as the regular JavaScript files will not survive the CoffeeScript compilation.
 
-This problem can be avoid though by using the ``apply_to`` option in the
-config, this allows you to specify that a filter is always applied to particular
+This problem can be avoided by using the ``apply_to`` option in the config,
+which allows you to specify that a filter should always be applied to particular
 file extensions. In this case you can specify that the Coffee filter is
 applied to all ``.coffee`` files:
 
@@ -144,11 +148,10 @@ applied to all ``.coffee`` files:
             ),
         ));
 
-
-
-So you can now remove specifying the filter in the Twig template and list
-any regular JavaScript files which will now be combined into the output
-file without having been run through coffee:
+With this, you no longer need to specify the ``coffee`` filter in the template.
+You can also list regular JavaScript files, all of which will be combined
+and rendered as a single JavaScript file (with only the ``.coffee`` files
+being run through the CoffeeScript filter):
 
 .. configuration-block::
 

cookbook/index.rst

@@ -13,6 +13,7 @@ Cookbook
     assetic/asset_management
     assetic/yuicompressor
     assetic/jpeg_optimize
+    assetic/apply_to_option
 
     doctrine/doctrine_fixtures
     doctrine/mongodb

cookbook/map.rst.inc

@@ -13,6 +13,7 @@
   * :doc:`/cookbook/assetic/asset_management`
   * :doc:`/cookbook/assetic/yuicompressor`
   * :doc:`/cookbook/assetic/jpeg_optimize`
+  * :doc:`/cookbook/assetic/apply_to_option`
 
 * **Database Interaction (Doctrine)**