added basic diff example and fixed misleading doc
Merge remote-tracking branch 'cholin/features/diff_docs'