docstring of interactive add function