improving docs with example