Reworded the caution notes about AsseticBundle

Author: javiereguiluz

best_practices/web-assets.rst

@@ -38,12 +38,8 @@ Using Assetic
 .. caution::
 
     Starting from Symfony 2.8, Assetic is no longer included by default in the
-    Symfony Standard Edition. Before using any of its features, install the
-    AsseticBundle executing this command command in your project:
-
-    .. code-block:: cli
-
-        $ composer install symfony/assetic-bundle
+    Symfony Standard Edition. Refer to :doc:`this article </cookbook/assetic/asset_management>`
+    to learn how to install and enable Assetic in your Symfony application.
 
 These days, you probably can't simply create static CSS and JavaScript files
 and include them in your template. Instead, you'll probably want to combine

cookbook/assetic/apply_to_option.rst

@@ -7,12 +7,8 @@ How to Apply an Assetic Filter to a specific File Extension
 .. caution::
 
     Starting from Symfony 2.8, Assetic is no longer included by default in the
-    Symfony Standard Edition. Before using any of its features, install the
-    AsseticBundle executing this command command in your project:
-
-    .. code-block:: cli
-
-        $ composer install symfony/assetic-bundle
+    Symfony Standard Edition. Refer to :doc:`this article </cookbook/assetic/asset_management>`
+    to learn how to install and enable Assetic in your Symfony application.
 
 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

cookbook/assetic/asset_management.rst

@@ -10,9 +10,60 @@ How to Use Assetic for Asset Management
     Symfony Standard Edition. Before using any of its features, install the
     AsseticBundle executing this command command in your project:
 
-    .. code-block:: cli
+    .. code-block:: bash
 
-        $ composer install symfony/assetic-bundle
+        $ composer require symfony/assetic-bundle
+
+    Then, enable the bundle by adding the following configuration under the
+    ``asetic`` key:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # app/config/config.yml
+            assetic:
+                debug:          "%kernel.debug%"
+                use_controller: false
+                filters:
+                    cssrewrite: ~
+
+            # ...
+
+        .. code-block:: xml
+
+            <!-- app/config/config.xml -->
+            <?xml version="1.0" encoding="UTF-8" ?>
+            <container xmlns="http://symfony.com/schema/dic/services"
+                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                xmlns:framework="http://symfony.com/schema/dic/symfony"
+                xmlns:twig="http://symfony.com/schema/dic/twig"
+                xsi:schemaLocation="http://symfony.com/schema/dic/services
+                    http://symfony.com/schema/dic/services/services-1.0.xsd
+                    http://symfony.com/schema/dic/symfony
+                    http://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
+
+                <assetic:config debug="%kernel.debug%" use-controller="%kernel.debug%">
+                    <assetic:filters cssrewrite="null" />
+                </assetic:config>
+
+                <!-- ... -->
+            </container>
+
+        .. code-block:: php
+
+            // app/config/config.php
+
+            $container->loadFromExtension('assetic', array(
+                'debug' => '%kernel.debug%',
+                'use_controller' => '%kernel.debug%',
+                'filters' => array(
+                    'cssrewrite' => null,
+                ),
+                // ...
+            ));
+
+            // ...
 
 Assetic combines two major ideas: :ref:`assets <cookbook-assetic-assets>` and
 :ref:`filters <cookbook-assetic-filters>`. The assets are files such as CSS,

cookbook/assetic/index.rst

@@ -4,12 +4,8 @@ Assetic
 .. caution::
 
     Starting from Symfony 2.8, Assetic is no longer included by default in the
-    Symfony Standard Edition. Before using any of its features, install the
-    AsseticBundle executing this command command in your project:
-
-    .. code-block:: cli
-
-        $ composer install symfony/assetic-bundle
+    Symfony Standard Edition. Refer to :doc:`this article </cookbook/assetic/asset_management>`
+    to learn how to install and enable Assetic in your Symfony application.
 
 .. toctree::
     :maxdepth: 2

cookbook/assetic/jpeg_optimize.rst

@@ -7,12 +7,8 @@ How to Use Assetic for Image Optimization with Twig Functions
 .. caution::
 
     Starting from Symfony 2.8, Assetic is no longer included by default in the
-    Symfony Standard Edition. Before using any of its features, install the
-    AsseticBundle executing this command command in your project:
-
-    .. code-block:: cli
-
-        $ composer install symfony/assetic-bundle
+    Symfony Standard Edition. Refer to :doc:`this article </cookbook/assetic/asset_management>`
+    to learn how to install and enable Assetic in your Symfony application.
 
 Among its many filters, Assetic has four filters which can be used for on-the-fly
 image optimization. This allows you to get the benefits of smaller file sizes

cookbook/assetic/php.rst

@@ -7,12 +7,8 @@ Combining, Compiling and Minimizing Web Assets with PHP Libraries
 .. caution::
 
     Starting from Symfony 2.8, Assetic is no longer included by default in the
-    Symfony Standard Edition. Before using any of its features, install the
-    AsseticBundle executing this command command in your project:
-
-    .. code-block:: cli
-
-        $ composer install symfony/assetic-bundle
+    Symfony Standard Edition. Refer to :doc:`this article </cookbook/assetic/asset_management>`
+    to learn how to install and enable Assetic in your Symfony application.
 
 The official Symfony Best Practices recommend to use Assetic to
 :doc:`manage web assets </best_practices/web-assets>`, unless you are

cookbook/assetic/uglifyjs.rst

@@ -7,12 +7,8 @@ How to Minify CSS/JS Files (Using UglifyJS and UglifyCSS)
 .. caution::
 
     Starting from Symfony 2.8, Assetic is no longer included by default in the
-    Symfony Standard Edition. Before using any of its features, install the
-    AsseticBundle executing this command command in your project:
-
-    .. code-block:: cli
-
-        $ composer install symfony/assetic-bundle
+    Symfony Standard Edition. Refer to :doc:`this article </cookbook/assetic/asset_management>`
+    to learn how to install and enable Assetic in your Symfony application.
 
 `UglifyJS`_ is a JavaScript parser/compressor/beautifier toolkit. It can be used
 to combine and minify JavaScript assets so that they require less HTTP requests

cookbook/assetic/yuicompressor.rst

@@ -13,12 +13,8 @@ How to Minify JavaScripts and Stylesheets with YUI Compressor
 .. caution::
 
     Starting from Symfony 2.8, Assetic is no longer included by default in the
-    Symfony Standard Edition. Before using any of its features, install the
-    AsseticBundle executing this command command in your project:
-
-    .. code-block:: cli
-
-        $ composer install symfony/assetic-bundle
+    Symfony Standard Edition. Refer to :doc:`this article </cookbook/assetic/asset_management>`
+    to learn how to install and enable Assetic in your Symfony application.
 
 Yahoo! provides an excellent utility for minifying JavaScripts and stylesheets
 so they travel over the wire faster, the `YUI Compressor`_. Thanks to Assetic,

reference/configuration/assetic.rst

@@ -7,12 +7,8 @@ AsseticBundle Configuration ("assetic")
 .. caution::
 
     Starting from Symfony 2.8, Assetic is no longer included by default in the
-    Symfony Standard Edition. Before using any of its features, install the
-    AsseticBundle executing this command command in your project:
-
-    .. code-block:: cli
-
-        $ composer install symfony/assetic-bundle
+    Symfony Standard Edition. Refer to :doc:`this article </cookbook/assetic/asset_management>`
+    to learn how to install and enable Assetic in your Symfony application.
 
 Full Default Configuration
 --------------------------