added basic diff example and fixed misleading docs

see #208