updated docs and examples