update documentation with examples