Beef out the docs to be a little more explanatory