Update pagination documentation

Updated to include details on the various properties that are included
on paginated result pages. Also added some example JSON.
Merge pull request #348 from mysociety/pagination-documentation

Update pagination documentation