Change list items to =head2

This makes for a much better TOC on metacpan
Fix typo in docs
More doc fixups

The parser metacpan uses likes a blank line before code blocks