➜

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 <1641069425.26.0.53296394622.issue46126@roundup.psfhosted.org>
In-reply-to
Content 
> > 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](https://blog.jaraco.com/why-docstrings-are-preferable-to-comments/) on my blog.
History
Date User Action Args
2022-01-01 20:37:05jaracosetrecipients: + jaraco, terry.reedy, eric.araujo, ethan.furman
2022-01-01 20:37:05jaracosetmessageid: <1641069425.26.0.53296394622.issue46126@roundup.psfhosted.org>
2022-01-01 20:37:05jaracolinkissue46126 messages
2022-01-01 20:37:05jaracocreate