Doc fixups

This makes some changes to the docs so they'll look better on metacpan. The two big changes are:

* I replaced list items for each method with headings so that metacpan can include them in a table of contents.
* I added some blank lines before code blocks. Metacpan's POD parser doesn't recognize them as code blocks without this.