improve paginator docs