updated defn docstrings