Merge branch 'rc-document-new-api-pagination-headers' into 'master'

Document new API pagination headers

Document new API pagination headers introduced in !2426. Solves #8098.

/cc @dzaporozhets @dblessing

See merge request !2435