diff --git a/best_practices/web-assets.rst b/best_practices/web-assets.rst index a45d85542b5..9d2570e0bd1 100644 --- a/best_practices/web-assets.rst +++ b/best_practices/web-assets.rst @@ -29,8 +29,8 @@ much more concise: .. note:: Keep in mind that ``web/`` is a public directory and that anything stored - here will be publicly accessible. For that reason, you should put your - compiled web assets here, but not their source files (e.g. SASS files). + here will be publicly accessible, including all the original asset files + (e.g. Sass, LESS and CoffeScript files). Using Assetic ------------- @@ -51,16 +51,15 @@ tools like GruntJS. :doc:`Assetic ` is an asset manager capable of compiling assets developed with a lot of different frontend technologies -like LESS, Sass and CoffeeScript. -Combining all your assets with Assetic is a matter of wrapping all the assets -with a single Twig tag: +like LESS, Sass and CoffeeScript. Combining all your assets with Assetic is a +matter of wrapping all the assets with a single Twig tag: .. code-block:: html+jinja {% stylesheets 'css/bootstrap.min.css' 'css/main.css' - filter='cssrewrite' output='css/compiled/all.css' %} + filter='cssrewrite' output='css/compiled/app.css' %} {% endstylesheets %} @@ -69,7 +68,7 @@ with a single Twig tag: {% javascripts 'js/jquery.min.js' 'js/bootstrap.min.js' - output='js/compiled/all.js' %} + output='js/compiled/app.js' %} {% endjavascripts %}