more examples and better documentation of functions