cleaned up commented tests
fleshed out docstrings for factory methods