News for hackers. Stuff that matters.

A comment on Reasons to avoid code comments .

Re:Reasons to avoid code comments by beaumartinez on Saturday July 13, 2013 @05:18AM (#6037107)
> Comments are not testable/verifiable

Although not strictly comments (rather, docstrings, which have a similar purpose), Python's doctest[1] allows you to write code in your docstrings and then test them for correctness.

[1] http://docs.python.org/2/library/doctest.html

[ Parent | on HN ]
Re:Reasons to avoid code comments by pauloortins on Saturday July 13, 2013 @11:59AM (#6037814)
It works only in python, I think. At time, where is the best practice when testing in python ? Doctests or unittest ?
[ Parent | on HN ]