#4 Improve documentation

[Ewan Silver]

There is minimal documentation at the moment. At the minimum need to:

1. Beef up the Javadocs.
2. Write up an overview of the system
3. Describe how to build a very basic app.
4. Write up description of the demos
5. Create a description of the nio system.