more docs, mostly complete api
fix numpydoc warnings and one docstring