Document all the things

[davidpdrsn]

All public items must have docs and we should add a bunch more examples.

This is blocked on building more parts of the API. I don't feel we should spend time documenting things while they're still so much in flux.