added more docs and examples