Moar text...

I'm merging this in as I've changed far too much stuff to describe... hopefully the document will become more stable soon.