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.2 responses total.
10 years and counting. Everyone still hates program documentation.
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.
You have several choices: