I have yet to understand the point of docstrings.
How are they, in practical reality, better than comments?
How are they, in practical reality, better than comments?
The way we work, it's just a different comment syntax. I do like have a dedicated place for it.
All Python programmers already benefit from the docstrings written in the libraries they use, which generate tooltips and documentation websites.
prior to mypy/type hints it allowed you to document the types of a function