improved docs with example