update changelog and add some more examples to the docs