Merge branch '3.4'

* 3.4:
  removing unnecessary note
  Re-adding index
  fixing index problem now that there were *no* frontend articles on 2.7
  Removing bower, as even they now recommend to use yarn and webpack
  [Encore] Fix invalid javascript code
  Changed link to Capifony
  cs
  Fix missing line
  Update bootstrap.rst
  resolve_url_loader codeblock did not contain valid javascript
  Encore tweaks!

Author: weaverryan

_build/redirection_map

@@ -164,7 +164,7 @@
 /cookbook/form/inherit_data_option /form/inherit_data_option
 /cookbook/form/unit_testing /form/unit_testing
 /cookbook/form/use_empty_data /form/use_empty_data
-/cookbook/frontend/bower /frontend/bower
+/cookbook/frontend/bower /frontend
 /cookbook/frontend/index /frontend
 /cookbook/install/unstable_versions /setup/unstable_versions
 /cookbook/install/bundles /setup/bundles

deployment.rst

@@ -198,7 +198,7 @@ Don't forget that deploying your application also involves updating any dependen
 (typically via Composer), migrating your database, clearing your cache and
 other potential things like pushing assets to a CDN (see `Common Post-Deployment Tasks`_).
 
-.. _`Capifony`: http://capifony.org/
+.. _`Capifony`: https://github.com/everzet/capifony
 .. _`Capistrano`: http://capistranorb.com/
 .. _`sf2debpkg`: https://github.com/liip/sf2debpkg
 .. _`Fabric`: http://www.fabfile.org/

frontend.rst

@@ -66,16 +66,18 @@ Other Front-End Articles
 ........................
 
 .. toctree::
-    :maxdepth: 1
+    :hidden:
     :glob:
 
-    frontend/*
+    frontend/encore/installation
+    frontend/encore/simple-example
+    frontend/encore/*
 
 .. toctree::
-    :hidden:
+    :maxdepth: 1
     :glob:
 
-    frontend/encore/*
+    frontend/*
 
 .. _`Webpack Encore`: https://www.npmjs.com/package/@symfony/webpack-encore
 .. _`Webpack`: https://webpack.js.org/

frontend/bower.rst

@@ -21,7 +21,7 @@ a ``global.scss`` file, import it from there:
     // assets/css/global.scss
 
     // customize some Bootstrap variables
-    $brand-primary:         darken(#428bca, 20%);
+    $brand-primary: darken(#428bca, 20%);
 
     // the ~ allows you to reference things in node_modules
     @import '~bootstrap-sass/assets/stylesheets/bootstrap';
@@ -41,8 +41,8 @@ this, you can use the ``resolve_url_loader`` option:
 
     // webpack.config.js
     Encore
-    +     enableSassLoader({
-    +         'resolve_url_loader' => false
+    +     .enableSassLoader({
+    +         resolve_url_loader: false
     +     })
     ;
 
@@ -79,6 +79,7 @@ Next, make sure to call ``.autoProvidejQuery()`` in your ``webpack.config.js`` f
     Encore
         // ...
     +     .autoProvidejQuery()
+    ;
 
 This is needed because Bootstrap expects jQuery to be available as a global
 variable. Now, require bootstrap from any of your JavaScript files:

frontend/encore/bootstrap.rst

@@ -1,9 +1,9 @@
-Installation
-============
+Encore Installation
+===================
 
-First, make sure you `install Node.js`_ and also the `yarn package manager`_.
+First, make sure you `install Node.js`_ and also the `Yarn package manager`_.
 
-Then, install Encore into your project with yarn:
+Then, install Encore into your project with Yarn:
 
 .. code-block:: terminal
 
@@ -21,11 +21,11 @@ is also created/updated. When using npm 5, a ``package-lock.json`` file is creat
 .. tip::
 
     You should commit ``package.json`` and ``yarn.lock`` (or ``package-lock.json``
-    if using npm) to version control, but ignore ``node_modules/``.
+    if using npm 5) to version control, but ignore ``node_modules/``.
 
 Next, create your ``webpack.config.js`` in :doc:`/frontend/encore/simple-example`!
 
 .. _`install Node.js`: https://nodejs.org/en/download/
-.. _`yarn package manager`: https://yarnpkg.com/lang/en/docs/install/
+.. _`Yarn package manager`: https://yarnpkg.com/lang/en/docs/install/
 .. _`npm`: https://www.npmjs.com/
 .. _`yarn`: https://yarnpkg.com/

frontend/encore/installation.rst

@@ -139,7 +139,16 @@ may want also to :doc:`create a shared entry </frontend/encore/shared-entry>` fo
 Requiring CSS Files from JavaScript
 -----------------------------------
 
-You can also require CSS files from your JavaScript:
+Above, you created an entry called ``app`` that pointed to ``main.js``:
+
+.. code-block:: javascript
+
+    Encore
+        // ...
+        .addEntry('app', './assets/js/main.js')
+    ;
+
+Once inside ``main.js``, you can even require CSS files:
 
 .. code-block:: javascript
 
@@ -149,17 +158,8 @@ You can also require CSS files from your JavaScript:
     // a CSS file with the same name as the entry js will be output
     require('../css/main.scss');
 
-In this case, ``main.js`` is being added to an entry called ``app`` in ``webpack.config.js``:
-
-.. code-block:: javascript
-
-    Encore
-        // ...
-        .addEntry('app', './assets/js/main.js')
-
-As soon as you require a CSS file, both an ``app.js`` **and** an ``app.css`` file
-will be created. You'll need to add a link tag to the ``app.css`` file in your
-templates:
+Now, both an ``app.js`` **and** an ``app.css`` file will be created. You'll need
+to add a link tag to the ``app.css`` file in your templates:
 
 .. code-block:: diff
 

frontend/encore/simple-example.rst

@@ -73,6 +73,7 @@ decided to move some configuration to a new file:
         // ... some services
 
 To import this file, use the ``imports`` key from a file that *is* loaded:
+
 .. configuration-block::
 
     .. code-block:: yaml