added documentation
make the example really clear
fixed docs