It's harder to read code than to write it

We've done DEVshirt's version of a classical programmers quote: "It is harder to read code than to write it" .
When you are junior it feels like writing code is your superpower, but as you age you realise that reading code is actually higher valued and a skill which is harder to learn.
We went with ying yang symbolism as every senior was once a junior.
We hope that you'll enjoy our illustrated version of "reading code is hard" statement 😛

Full quote

We’re programmers. Programmers are, in their hearts, architects, and the first thing they want to do when they get to a site is to bulldoze the place flat and build something grand. We’re not excited by incremental renovation: tinkering, improving, planting flower beds. There's a subtle reason that programmers always want to throw away the code and start over. The reason is that they think the old code is a mess. And here is the interesting observation: they are probably wrong. The reason that they think the old code is such a mess is because of a cardinal, fundamental law of programming: It’s harder to read code than to write it.

Original quote

Link to original quote by Joel Spolsky - (keep in mind it is an article)

T-shirt design

We believe there is some fundamental truth in this quote. Because of that we wanted to do something special with illustration. Enhance the quote with more fundamental truths. It is the perfect opportunity to subtly embed ying yang into the design. Make junior developer write code while senior reads it. If you look carefully you'll also notice the depth of this illustration. It has 2 clocks in it. The junior is using modern clock while senior is using analog clock, they represent the time passing by and the dots in ying yang. Because with time every junior will eventually become senior. And every senior was once a junior. Even though there is an age difference between them, each has a small part of other. With that in mind cherish and coach your junior colleagues. And if you're a junior, try to respect senior colleagues who wrote the original code

Why is writing easier than reading

When coding you'll often get immersed into the business domain. Ideas will flow back and forth trough your head. You'll be full of all kinds of different information. Different code paths you can take will appear. You'll weigh pros and cons of each. And finally you will write your notes in a form of computer program. On the other hand, when you read code, all you have are those notes. And to be precise notes are a bad word for it. Code is often just a bunch of instructions to a machine. Even if it's code you've originally written, you won't have access to all the background information. It's hard to remember all the business domain decisions that went into writing that code. It's even harder to backtrack from instructions all the way to why a certain path was taken. It's significantly different than reading a book. In book if you miss a certain information it will be repeated. In code on other hand we aim for DRY(don't repeat yourself). So missing an information can cause us to misunderstood the whole point of program.
Reading code is actually easy. Understanding what was written and why is extremely hard. It simply requires an insane amount of mental effort to be put in.

Get inspired

We have originally created this images in order to share them on our twitter. Since they are on the same topic: "code writing versus code reading", you might find them enjoyable:

‍