Added clarity around pagination limits.

Have been caught out by this a couple of times now so thought I'd add some documentation around how the pagination limits work. This may be a little verbose but some clarification in the documentation is definitely needed.