Docstrings should look more like docstrings and less like design docs