added some comments and type fixes in comments
typo fix in docstring
paginator fix