Clean up build system and add demos

readme.md

@@ -6,24 +6,30 @@ Run make:
 
     $ make
 
-## Run the example
+## Run the examples
 
-Run the [plovr](http://plovr.com/) web server with:
+Run make (as above), then explore the `demos/` directory with your web browser.
+
+## Run the examples in debug mode
+
+Run the [Plovr](http://plovr.com/) web server with:
 
     $ make serve
 
-Then open skeleton.html in the browser (e.g.
-<http://localhost/~elemoine/ol3/skeleton.html>).
+Then, start a simple webserver, for example:
+
+    $ python -mSimpleHTTPServer
+
+Explore the `demos/` directory through this server, for example <http://localhost:8000/demos/side-by-side/debug.html>. You can turn off compilation by appending `?mode=RAW` to the URL, for example <http://localhost:8000/demos/side-by-side/debug.html?mode=RAW>.
+
+Note that appending `?mode=RAW` doesn't work with `file://` URLs, which is why you need to access the `demos/` directory though a web server.
 
 ## Run tests
 
-Run the plovr web server (see above), then open <http://localhost:9810/> in
-your browser and select *List of tests* or *Test runner*.
+Run the plovr web server (see above), then open <http://localhost:9810/> in your browser and select *List of tests* or *Test runner*.
 
 ## Run the linter
 
-First, install the [Closure
-Linter](https://developers.google.com/closure/utilities/docs/linter_howto).
-Then:
+First, install the [Closure Linter](https://developers.google.com/closure/utilities/docs/linter_howto).  Then:
 
     $ make lint