add doc blocks
add an pseudo working example of multi-pagination

in the same request:wq