add docs and example to pagination