How to read code

I was going through this interesting article on how to read code thanks to a Smashing Magazine link on Twitter. It was an interesting read, although, I felt that it missed out on a couple of important aspects in the code we read now-a-days.

A lot of the code we write these days is built on existing layers of libraries, both server-side and client side. A frequent problem that I have seen programmers reading someone else’s code is that they tend to skip library functions and try to continue reading the code written by one of their colleagues. Now that wouldn’t be a problem except if the programmer does not understand the functionality of the library API being used, the risk of misinterpreting the code or the code remaining vague increases.

Some common examples of libraries being used extensively in our client side code include jQuery and on the server-side, if you are a .NET programmer, there are numerous Dot Net classes.

So, I would definitely recommend that if you are reading code to understand, make sure you understand the syntax, keywords and the API being used of any library within that code.

Other than this, in the old days, about a decade back, we never had such great debugging tools such as we have today for almost any platform. Therefore, we relied more on dry runs. I do not have a scientific reason or a survey to back me up, but I have seen guys who are used to dry runs troubleshoot much faster than guys who are dependent on debugging tools to catch an issue. So I would definitely recommend dry runs where you read code and at every stage visualize the inputs and outputs for each block of code.

So, go ahead, read the article above, but include the two below in your list:

  1. Dry Runs
  2. Understand the API of libraries used in the code being reviewed or read for understanding

3 thoughts on “How to read code

  1. Pingback: How to read code (via Kartik Sehgal’s Blog) « Assign Labs

Leave a Reply

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

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

Google+ photo

You are commenting using your Google+ 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 )


Connecting to %s