Initial docs

@keflavich @ChrisBeaumont - this is a first stab at the docs. In fact, I thought this would be a good chance to try and make sure we have the ideal API, so the current docs don't reflect the current API exactly, but if you agree with the docs, I can make the small changes required for this to work. So let me know what you think of the API described here.