adds doc examples for compare methods
Merge pull request #8 from pflannery/add-compare-method-examples

adds doc examples for compare methods