#28: existing unit tests now actually pass
#28: finished tests and updated documentation