Generally, this is a good idea for public ones. It's more than cosmetics, it's about exposing documentation to the user. For example, some IDEs show docstrings on hover (this is PyCharm): And PEP 257 ...