cleanup and clarify

I thought this version of the documentation read better, so here you go.