minor improvement and doc
correcting headline and adding documentation
better docs
more examples