improve docs and describe my actual usage