I suggest the attached new page of documentation on pagination.
Arguably, it's not necessary, since paginate() in decorators.py has a good docstring, but:
a usage sample still helps
currently, searching on paginate in the TG2 docs only brings up the webhelpers.paginate page, which is terribly confusing - it implies you need to go figure out the raw Pylons stuff on your own.