update documentation and examples