README: Updated to include demo development instructions

Author: ZechyW

README.md

@@ -93,16 +93,26 @@ To run the demo on a different port, set the `PORT` environmental variable. For
 
 TAG is written in ES6, and uses [Sass](https://sass-lang.com/) for its styles.
 
-Assuming you've cloned the repository, simply run `npm install && npm run build` to install dependencies and transpile the source to ES2015.
+Assuming you've cloned the repository and installed its dependencies, run `npm run build` to transpile the source to ES2015 and generate the library bundles (`dist/tag`) and documentation (`docs`).
+
+To rebuild the sources for the demo, run `npm run demo-build`.
 
 ### Live monitoring of changes
 
-For convenience, you can monitor changes to the library's sources (css + js) with the following `npm` task: 
+For convenience, you can monitor changes to the library's sources (in the `src` folder) with the following `npm` task, which will regenerate the files in the `dist/tag` folder:
 
 ```
 npm run watch
 ```
 
+If you are experimenting with the demo and would like to monitor changes to the demo sources (in the `demo` folder), use the following `npm` task instead:
+
+```
+npm run demo-watch
+```
+
+The `demo-watch` task will also catch changes to the library sources and rebuild the demo bundles, but it will *not* directly rebuild the library bundles in `dist/tag`, so be sure to run `npm run build` separately if you intend to redistribute/repackage your changes to the library sources.
+
 ### Generating documentation
 
 TAG uses [JSDoc](http://usejsdoc.org/) to generate its documentation. By default, the documentation is generated using the template in `src/jsdoc-template` (adapted from the [Braintree JSDoc Template](https://github.com/braintree/jsdoc-template)) and stored in the `docs` folder.

docs/index.html

@@ -135,8 +135,10 @@ <h3>Demo</h3><p>After cloning the repository and installing the project dependen
 <p>To run the demo on a different port, set the <code>PORT</code> environmental variable. For example, running <code>PORT=9000 npm run demo</code> will start the demo server on <code>localhost:9000</code> instead.</p>
 <h3>Building the source</h3><p>TAG is written in ES6, and uses <a href="https://sass-lang.com/">Sass</a> for its styles.</p>
 <p>Assuming you've cloned the repository, simply run <code>npm install &amp;&amp; npm run build</code> to install dependencies and transpile the source to ES2015.</p>
-<h3>Live monitoring of changes</h3><p>For convenience, you can monitor changes to the library's sources (css + js) with the following <code>npm</code> task: </p>
-<pre class="prettyprint source"><code>npm run watch</code></pre><h3>Generating documentation</h3><p>TAG uses <a href="http://usejsdoc.org/">JSDoc</a> to generate its documentation. By default, the documentation is generated using the template in <code>src/jsdoc-template</code> (adapted from the <a href="https://github.com/braintree/jsdoc-template">Braintree JSDoc Template</a>) and stored in the <code>docs</code> folder.</p>
+<h3>Live monitoring of changes</h3><p>For convenience, you can monitor changes to the library's sources (in the <code>src</code> folder) with the following <code>npm</code> task, which will regenerate the files in the <code>dist/tag</code> folder.</p>
+<pre class="prettyprint source"><code>npm run watch</code></pre><p>If you are experimenting with the demo and would like to monitor changes to the demo sources (in the <code>demo</code> folder), use the following <code>npm</code> task instead:</p>
+<pre class="prettyprint source"><code>npm run demo-watch</code></pre><p>The <code>demo-watch</code> task will also catch changes to the library sources and rebuild the demo bundles, but it will <em>not</em> directly regenerate the library bundles in <code>dist/tag</code>.</p>
+<h3>Generating documentation</h3><p>TAG uses <a href="http://usejsdoc.org/">JSDoc</a> to generate its documentation. By default, the documentation is generated using the template in <code>src/jsdoc-template</code> (adapted from the <a href="https://github.com/braintree/jsdoc-template">Braintree JSDoc Template</a>) and stored in the <code>docs</code> folder.</p>
 <p>To regenerate the documentation, use the following <code>npm</code> task:</p>
 <pre class="prettyprint source"><code>npm run generate-docs</code></pre>
     </article>

package.json

@@ -8,8 +8,9 @@
     "build": "run build:all",
     "quick": "run build:quick",
     "watch": "run watch:quick",
-    "demo-build": "run demo:build:all && run demo:run",
     "demo": "run demo:run",
+    "demo-build": "run demo:build:all",
+    "demo-watch": "run demo:watch:all",
     "generate-docs": "run build:app:docs:all"
   },
   "repository": {