use more self-speakable public api definiton that shows possible arguments