discovery: add clarifying docstrings

/cc @xiangli-cmu