working on documentation, lots of docstring updates