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.
We were using them in our tests.  I can't be confident other people haven't either.  But I can remove them if I'm just being paranoid.