update docs and examples