Update README.md

Some actual documentation has been added. Not a huge amount, but it's a start.

Also placeholders for future documentation. Structure may change though.