added docstrings.  cleaned up README