docs and example improvements
docs and examples