Self Documenting Code Vs. Commented Code

Posted by Phill on Programmers See other posts from Programmers or by Phill
Published on 2011-02-24T09:14:50Z Indexed on 2011/02/24 15:32 UTC
Read the original article Hit count: 367

Filed under:
|

I had a search but didn't find what I was looking for, please feel free to link me if this question has already being asked.

Earlier this month this post was made:

http://net.tutsplus.com/tutorials/php/why-youre-a-bad-php-programmer/

Basically to sum it up, you're a bad programmer if you don't write comments. My personal opinion is that code should be descriptive and mostly not require comment's unless the code cannot be self describing.

In the example given

// Get the extension off the image filename  
$pieces = explode('.', $image_name);  
$extension = array_pop($pieces);  

The author said this code should be given a comment, my personal opinion is the code should be a function call that is descriptive:

$extension = GetFileExtension($image_filename);

However in the comments someone actually made just that suggestion:

http://net.tutsplus.com/tutorials/php/why-youre-a-bad-php-programmer/comment-page-2/#comment-357130

The author responded by saying the commenter was "one of those people", i.e, a bad programmer.

What are everyone elses views on Self Describing Code vs Commenting Code?

© Programmers or respective owner

Related posts about coding-standards

Related posts about comments