Cleanup docs

I've done some work on the POD both to clean up the formatting and also to restructure the content itself.  I've changed the documentation style significantly, and I'll understand if you only want to take the formatting fixes, so I split it into two changes.