CLN/ENH: clean up docstrings remove some cruft and generalize