docs updated with example