Return Styles: Pseud0ch, Terminal, Valhalla, NES, Geocities, Blue Moon. Entire thread

Commenting

Name: Anonymous 2010-03-29 15:07

Tricky code should not be commented but rewritten

In general, the use of comments should be minimized by making the code self-documenting by appropriate name choices and an explicit logical structure.

Name: Anonymous 2010-03-29 17:03

>>3
The problem with overcommenting is that you have to update not only your code, but also the comments and documentation. While not a real bug, desynced comments and source code can mislead developers(yourself included, after a few months) which rather undesirable. Desynced source and documentation is a bug because the software does not conform to the spec you wrote for it yourself.

Newer Posts
Don't change these.
Name: Email:
Entire Thread Thread List