added examples
more documentation…