updating readme, tweaking docstring