Quote:
Originally Posted by k0nr4d
Im not gonna say im against commenting because its sometimes useful when something is done complicated or strange for some specific reason, but the fact is if someone cant figure out what a piece of code does from looking at it, they have no business editing it.
As long as you use self-explainatory function names and variables...
|
Just because something may seem logical to you and the flow of information is something you architected... it doesn't necessarily mean it's going to be logical to someone else...
The next guy that comes along may normally follow a completely different design paradigm or maybe they're just inexperienced...
Good commenting practices make code (however clean it may be) easier for everyone that follows after you.