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.
Well, for now, then, let's make it initial caps when referring to a type and all lowercase when referring to a concept.  Good?