update api docstrings and top level docs