Document All The Things (At Once)

This should be enough to get us by for now.

I'm going to make it a hard requirement from now on that pull requests contributing significant new functionality come with documentation.
I think this needs a bit more description, but I can have a go at it if you would rather not deal with trying to explain zippers to the incoming Objective-C crowd.  :)