Become a better programmer

Why do some programmers seem to have this magical ability to extract meaning from code in the blink of an eye?

To try and answer this question I’ve gone digging to see what science knows about how we understand code.

As it turns out we know a lot about the psychology of code comprehension and we can use this knowledge to become better programmers. It allows you to develop all aspects of the understanding process so you don’t end up with bottlenecks in your programming skills.

In this post I take a look at what we know about program understanding and discuss three ways we can use this knowledge to become better programmers.

To understand code you have to build a mental model

The first step when programming is to build a mental model of the problem so you can then complete your task. Your mental model is the driver behind understanding a problem or program.

The journey from code on a screen to a model in your head follows a fairly well understood progression. Our understanding of the process is by no means complete but what we do know can be used to identify areas to focus on for improvement.

Let’s take a look at how we understand code.

Your mental model is built up of matches between general and specific knowledge.

The knowledge you use to understand your code is either general programming knowledge or software specific knowledge.

General knowledge includes knowledge about computer science concepts, programming languages, frameworks, and programming principles. Most tutorials will focus on this type of knowledge — things like design patterns, effective web stacks, proven enterprise architectures, anything generally applicable to a variety of solutions. Specific knowledge is knowledge about the particular program or problem you are busy with.

Forming a mental model consists of making associations between the code you are reading and your existing general and specific knowledge. “This is a class“. “That is a loop“. “This function is filtering invoices by price“.

Both of these types of knowledge can be new or existing. Sometimes you will need to learn new general knowledge to solve a problem. How a round robin scheduler works, for example. Specific knowledge is more often new than existing, but sometimes you will have existing knowledge about the program you are currently working on through a history with that particular codebase.

Your mental model consists of the set of links between the general and specific knowledge you have that is relevant to this problem.

These matches are formed by making, testing and modifying hypotheses.

The way we form matches is by making hypotheses.

Let’s say you spot something that you recognise in the code. A beacon that reminds you of some higher level concept. “That loop looks like a sort“.

You then look for ways to test this hypothesis. “Let’s see if we are swapping two items in the loop“.

We then modify the hypothesis or accept it and start looking for new hypotheses to build on the one we just made.

You make a prediction about what something is, find ways to prove or disprove your prediction, modify based on results and repeat.

So how does this help us in understanding how to be a better programmer?

There are three ways you can become a better programmer:

Once you know that your ability to understand code is dependent on three things:

  1. Knowledge — The building blocks to solve the problem
  2. Links — The glue between the building blocks
  3. Hypotheses — The tools by which you form the links

It becomes clear that getting better at programming requires a holistic approach.

1. You can gain more general knowledge

Since your ability to comprehend code depends on the number of matches you can make between your existing knowledge and the problem you are trying to solve it stands to reason that the more knowledge you have to work with the more success you will have.

As programmers we spend a large portion of our time acquiring new knowledge. It’s necessary if you want to stay current in the technology world. To get the most out of your research it’s important to focus on principles and not technologies.

With that in mind let’s look at the types of knowledge you can add to your bag of tricks:

Language specific knowledge

Language specific knowledge is the area many developers focus on.

It’s about learning the ins and outs of your language or framework of choice. Getting to know the API and language constructs, finding the strange language quirks and knowing exactly how things work under the hood.

It is usually fairly easy to find good courses and information for this category of knowledge.

Some places worth checking out:

This kind of knowledge is vital and every developer needs to know his tool-set inside out.

The problem with this kind of knowledge is that there’s always more. A new framework comes out. The next version of a language is released. The longer you have had this knowledge the less valuable it becomes (knowing how to read a punch-card isn’t a hot skill anymore)

Programming concepts

This type of knowledge has a longer shelf life. A sort will still be a sort in 20 years time.

Computer Science degrees spend a lot of time on these topics. You also learn these concepts as a side effect of learning languages and frameworks. The problem with learning these concepts from a language or framework is that it’s sometimes difficult to separate the underlying concept from how it is expressed in syntax.

Some languages are also better or worse at expressing certain concepts. Knowing a few different frameworks and languages is helpful here. The alternative is to learn the concepts first and then learn how it is applied in different languages. It is much harder to find information and courses that take this approach. These concepts includes things like patterns, algorithms, data structures and many more.

Over time I will be releasing more content that focuses on learning the underlying concepts.

Sign up here for a free e-book on the topic and to be notified of new content.

Domain knowledge

Understanding the industry you are working in gives you an extra set of non programming concepts to use in your mental model. Understanding how an investment instrument works helps you understand code dealing with investment instruments.

2. You can get better at matching code to general knowledge

Once you have enough general knowledge you can focus on getting better at forming matches. If you know what clues to look for in the code and practice identifying them you will quickly get better at extracting meaning from code.

Learn to recognize code beacons

Code beacons are patterns in your code that hint at an underlying concept. These patterns can span varying levels of complexity. They are snippets of code that light the way to higher level concepts.

For example, when you see code that follows this pattern:

Iterate over the elements in an array

Put elements into a new array based on a condition

You know you are dealing with a filter.

Thinking about this block of code as “a filter” instead of “a loop, with an if condition that then puts some items from the old array into a new array” allows you to hold more ideas in your head at the same time. You chunk a few smaller ideas into a bigger one.

Traditionally in software development a “pattern” refers to the famous gang of four book Design Patterns: Elements of Reusable Object-Oriented Software. While code beacons and design patterns are related they are not the same thing. For example, there are code beacons for design patterns.

In a future post I will list some of these beacons and explain how to identify them.

Learn the rules of discourse

Rules of discourse are the conventions and coding styles used within a framework or language. Just like the dialogue rules in a conversation they set expectations in the mind of the programmer. The way you name methods is different in Ruby and C#. Rails makes heavy use of the MVC pattern, other frameworks don’t (Meteor.js for example).

Writing code that follows the expected rules of discourse makes the code significantly easier to understand. Even for experts.

This bit comes fairly naturally, you pick up these rules from reading example code or from your colleagues. Sometimes when moving to a new language or framework it is worth paying special attention to this. It’s a quick way to feel more comfortable in a new language.

3. You can get better at forming and revising hypotheses

The last piece of the puzzle is getting better at forming and revising hypotheses. The better you are at making a hypothesis that is likely to be correct the faster you will be able to build your mental model.

Use a systematic approach

A systematic approach to building a mental model involves reading every line of code and focusing on building your knowledge as you go. It generally yields the best results but quickly becomes impractical for larger code bases. This is best suited for highly critical code that is of a manageable size. I’ve found this to be quite rare in the real world. Usually you deal with large sprawling code bases that have grown over many years.

Use an opportunistic approach

With an opportunistic approach you look for interesting pieces of code, form a hypothesis about what it does then start digging to see if you are on the right track. Being good at recognizing beacons both at the syntax level and at the higher levels of abstractions really help you form better hypotheses.

The results in terms of complete understanding are not as good with this approach but you get to a relatively good understanding much quicker. This is also what leads to making a quick fix and then breaking some other part of the system you didn’t understand though, so be careful.

To become a world class programmer you need to master all three

We all want to be the best programmers we can be. In today’s technology world where things change all the time it can be challenging keeping up with all the latest frameworks and methodologies. Luckily you can gain an advantage over the other programmers out there. If you know what to look for and can identify your weak points, you can progress further and faster with the same amount of effort.

To me the thing that distinguishes a decent programmer from a truly excellent one has always been how well they understand the core concepts in programming.

What makes a programmer exceptional to you? Let me know in the comments below.