Edit docs for hacks

fix grammar and formatting, and elaborate to be clearer