fixup docs (mostly formatting)

(@stefanpenner / @rjackson)