added pagination, updated docs and readme