Khangharoth

April 6, 2007

Comment your Code

Filed under: Software Design — khangharoth @ 1:21 pm

After three years of Software experience now i am finally able to understand the importance of commenting the code.

And its not for other guys ,its for you also.That more complex is the piece of code in terms of businesses requirements harder it will be for you to understand after say 6 months.

Also while commenting emphasis should not be much on technical details as but more on business requirement.While coding initially you thought some common solution will solve this problem but after getting all the requirements you realized that this is a special case and hence need some weird logic.Document it ,because chances are the everybody else and you also (after 4 months ) will again think why can’t this be done in a simpler way.

I sometime back read somewhere on net

Good programmers comment their code.

Great programmers comment on why they choose a particular implementation.

Master programmers comment on why they didn’t choose other implementations.

This can be a good philosophy for commenting your good.

Advertisements

1 Comment »

  1. Its like you learn my mind! You appear to know so
    much approximately this, like you wrote the ebook in it or something.
    I think that you just could do with some % to
    power the message home a bit, however other than that, this is excellent
    blog. A fantastic read. I will definitely be back.

    Comment by Auto Insurance in Little Rock Arkansas — January 12, 2014 @ 4:26 pm | Reply


RSS feed for comments on this post. TrackBack URI

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

Blog at WordPress.com.

%d bloggers like this: