adds doc examples for compare methods