updates documentation and examples