Rewords

Author: javiereguiluz

frontend.rst

@@ -73,7 +73,6 @@ Guides
 * :doc:`Passing Information from Twig to JavaScript </frontend/encore/server-data>`
 * :doc:`webpack-dev-server and Hot Module Replacement (HMR) </frontend/encore/dev-server>`
 * :doc:`Adding custom loaders & plugins </frontend/encore/custom-loaders-plugins>`
-* :doc:`Configuring Watching Options and Polling </frontend/encore/watch-options>`
 * :doc:`Advanced Webpack Configuration </frontend/encore/advanced-config>`
 
 Issues & Questions

frontend/encore/advanced-config.rst

@@ -38,6 +38,20 @@ But be careful not to accidentally override any config from Encore:
     // BAD - this replaces any extensions added by Encore
     // config.resolve.extensions = ['json'];
 
+Configuring Watching Options and Polling
+----------------------------------------
+
+Encore provides the method ``configureWatchOptions()`` to configure
+`Watching Options`_ when running ``encore dev --watch`` or ``encore dev-server``:
+
+.. code-block:: javascript
+
+    Encore.configureWatchOptions(function(watchOptions) {
+        // enable polling and check for changes every 250ms
+        // polling is useful when running Encore inside a Virtual Machine
+        watchOptions.poll = 250;
+    });
+
 Defining Multiple Webpack Configurations
 ----------------------------------------
 
@@ -207,3 +221,4 @@ The following loaders are configurable with ``configureLoaderRule()``:
 .. _`configuration options`: https://webpack.js.org/configuration/
 .. _`array of configurations`: https://github.com/webpack/docs/wiki/configuration#multiple-configurations
 .. _`Karma`: https://karma-runner.github.io
+.. _`Watching Options`: https://webpack.js.org/configuration/watch/#watchoptions