docs and examples update