better docs and examples