improved doc-strings