The Program Documentation item

Sep 17 00:19 UTC 2006

This is the program documentation item.  It focuses on comments, requirements
and design documents, self-documenting code, extracting documentation from
software using tools like javadoc, doc++ and doxygen, what to put in man
pages, etc.  Ask your program documentation questions here.

response 2 of 2:

Feb 15 01:51 UTC 2017

And I still pick up code from others that has zero comments.  No one
bothers to explain what this piece of code is intended to do (whether
it does it or not).  No wonder a lot of people start over from scratch
rather than try to figure out what other people did.  Good documentation
is very helpful.