update documentation and examples more