This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author jaraco
Recipients eric.araujo, ethan.furman, jaraco, terry.reedy
Date 2022-01-01.20:37:05
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <>
> > I presume I don't need to explain why docstrings are nice and preferable over comments.

> Actually, can you?

I searched around and didn't find any good treatise or thorough overview  of reasons _why_ docstrings should be preferred, so I performed an internal deconstruction of my motivations and published [this article]( on my blog.
Date User Action Args
2022-01-01 20:37:05jaracosetrecipients: + jaraco, terry.reedy, eric.araujo, ethan.furman
2022-01-01 20:37:05jaracosetmessageid: <>
2022-01-01 20:37:05jaracolinkissue46126 messages
2022-01-01 20:37:05jaracocreate