added some documentation, and some tests for my comparison functions