clarify docs and add sample