documentation

[fscottfoti]

Probably goes without saying, but I'll say it.

• [ ] I've been bad about writing doc strings
• [ ] We need high level descriptions, especially about the recipes
• [ ] We need annotated example notebooks
• [ ] We also need a reasonable readme with credit to the appropriate places