Cleaned up and clarified the documentation.
I think everything is in there now - the basics, anyway.