more docs and examples