loading...

re: Is Commenting Code that necessary? VIEW POST

FULL DISCUSSION
 

Too many comments are useless. The code should be self-documenting.

For example in one of my projects there was a function void setupToolbar. Recently someone added a comment to it. Now the code reads:

/*!
 * \brief setup Toolbar
 */
void setupToolbar()
 

yeah !! well said and the example is clear :)
That's why I used the statement "Don't use it everywhere"

code of conduct - report abuse