Add readme

README.md

@@ -0,0 +1,36 @@
+Tutorial Framework
+==================
+
+## Frontend dependencies
+
+These aren't checked in, until the preferred method of dependency management is decided. Until then, they can be
+downloaded from the following locations:
+
+* [jQuery](https://jquery.com/download/)
+* [Bootstrap](https://getbootstrap.com/docs/4.0/getting-started/download/)
+* [Popper.js](https://github.com/FezVrasta/popper.js#installation)
+* [Highlight.js](https://highlightjs.org/download/)
+* [Showdown](https://github.com/showdownjs/showdown/releases)
+
+## Building and running with Docker
+
+Simply issue `docker build .` in the root of the project. The first build could take a while as it's compiling a fresh
+Python package from source. Subsequent builds can reuse this layer, so their execution time is significantly shorter.
+
+Run with `docker run -p 4242:4242 <id>` to bind the container's port to localhost.
+
+## Running locally
+
+Open two terminals in the project root.
+
+Issue 
+```
+cd src/app/
+PYTHONPATH="../../lib/" python app.py
+```
+in one, and 
+```
+cd src/components/
+PYTHONPATH="../../lib/" python component_example.py
+```
+in the other.