I hate when developers writes useless comments in code like this
try{
}finally {
// Closing the connection
helper.closeConnection(cnn);
}
Anyone reading the function name close connection can figure out this is closing the connection.
I try to give function a meaningful name so that it conveys the intent and comments are not required. I write method comments only when function is doing some complex algorithm or some trick.
I also hate comments like this
/**
*
* @param customer
* @param ids
* @return
*/
This is also useless comment generated by eclipse automatically but the developer didn't added a comment.
Screen size is limited and I would rather see code in it than useless comments.
try{
}finally {
// Closing the connection
helper.closeConnection(cnn);
}
Anyone reading the function name close connection can figure out this is closing the connection.
I try to give function a meaningful name so that it conveys the intent and comments are not required. I write method comments only when function is doing some complex algorithm or some trick.
I also hate comments like this
/**
*
* @param customer
* @param ids
* @return
*/
This is also useless comment generated by eclipse automatically but the developer didn't added a comment.
Screen size is limited and I would rather see code in it than useless comments.
Comments
Post a Comment