lots more docs

Really, quite some work on the docs. I think this is now rtm for it's current version.