bugfix
expanded documentation with more examples