Fixes some PHP docblocks

Also type hints the $data parameter
Merge pull request #595 from pdewouters/docblocks

Fixes some PHP docblocks
Update routes.md

posts_per_page is actually a public query variable
Merge remote-tracking branch 'upstream/master'
Add comment post