Adds Browser Sync config for docs.

Author: Phally

CONTRIBUTING.md

@@ -75,6 +75,9 @@ You can build the documentation using Docker via the following commands:
 
     # open the generated html docs in docs/_build/html
 
+    # or use Browser Sync with automatic builds and browser refresh on file save
+    browser-sync start --config browser-sync-config.js
+
 # Additional Resources
 
 * [CakePHP coding standards](http://book.cakephp.org/2.0/en/contributing/cakephp-coding-conventions.html)

docs/browser-sync-config.js

@@ -0,0 +1,33 @@
+const { exec } = require("child_process");
+
+const docker = "docker run --rm -v $(pwd):/data friendsofcake/crud make html";
+
+module.exports = {
+  server: {
+    baseDir: "_build/html",
+    index: "index.html"
+  },
+
+  files: [
+    "_build/html/*.html",
+    {
+      match: ["**/*.rst", "**/*.php"],
+      fn: (event) => {
+        if (event !== 'change') {
+          return false;
+        }
+        exec(docker, (error, stdout, stderr) => {
+          if (error) {
+            console.error(error);
+            return;
+          }
+          console.log(stdout);
+        });
+        return false;
+      },
+      options: {
+        ignored: '_build'
+      }
+    }
+  ]
+};