improved DOCSTRINGS