update documentation with full example