Auto Code Commenting Software, Free Chairs

sien writes "When you think about it, code is usually fairly mundane and simple. Finally someone has come up with a parser and lexer that actually auto-comments code, allowing for vastly more rapid coding. This amazing new tool is called The Commentator and claims to analyse source code as it's being written and insert the necessary code comments. It's absolutely amazing. Also the problem of seating for eXtreme Programming has finally been solved."

Comments

Utterly useless to me

[Cheirdal]

I can look at any piece of code in any project I've worked on and see what the code technically does. What I can't do is look at something and say "Ah, this criteria exists in the code because of business rule #275 for customer X." Almost all my comments are related to business rules and what I'm trying to accomplish. There is no way an autocomment tool could analyze the code for the business rules I use.

Comments ... NO!

[jmartens]

Real programmers don't comment. If you did that someone might actually be able to figure out what you are doing. You need a code obfuscate function that takes simple functions and makes them complex and adds nonsensical comments, such as:

Before:
int i = 1;
while (i 1000) { ... A[i] ...;
i ++;
}

After: //Super Froopy node generator
int i=11; //Charge the Interociter
while (i 8003) { ... A[(i-3)/8] ...; //null node generator
i += 8;
}