clean up docstrings a bit to fix warnings