update docs and examples.