Change list items to titles

For #linking in the generated HTML docs
Fix docs for methods with different args for different collections
Merge pull request #32 from Stuk/readme-titles

Change list items to titles