add docs for compare diff feature

For #214.
Also corrected some bits that didn't make sense.