document Batman.ModelPaginator

Finally took the time to figure this bad boy out -- and another hidden gem! Definitely a few things missing (although the totalCount PR should fix one big thing), but the caching is way better than the one I made. 

Thanks again to you guys who made this!