minor symfony#9167 Improved the docs about multiple Webpack configs (javiereguiluz)

javiereguiluz · xabbuh · commit c831050da831 · 2018-01-31T13:29:17.000+01:00
This PR was merged into the 3.4 branch. Discussion ---------- Improved the docs about multiple Webpack configs This fixes symfony#9166. Commits ------- 68c92e9 Improved the docs about multiple Webpack configs
diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
@@ -63,6 +63,9 @@ state of the current configuration to build a new one:
     // build the first configuration
     const firstConfig = Encore.getWebpackConfig();
 
+    // Set a unique name for the config (needed later!)
+    firstConfig.name = 'firstConfig';
+
     // reset Encore to build the second config
     Encore.reset();
 
@@ -79,9 +82,19 @@ state of the current configuration to build a new one:
     // build the second configuration
     const secondConfig = Encore.getWebpackConfig();
 
+    // Set a unique name for the config (needed later!)
+    secondConfig.name = 'secondConfig';
+
     // export the final configuration as an array of multiple configurations
     module.exports = [firstConfig, secondConfig];
 
+When running Encore, both configurations will be built in parallel. If you
+prefer to build configs separately, pass the ``--config-name`` option:
+
+.. code-block:: terminal
+
+    $ yarn run encore dev --config-name firstConfig
+
 .. _`configuration options`: https://webpack.js.org/configuration/
 .. _`Webpack's watchOptions`: https://webpack.js.org/configuration/watch/#watchoptions
 .. _`array of configurations`: https://github.com/webpack/docs/wiki/configuration#multiple-configurations
