documentation and examples updated