Tech and Media Labs
This site uses cookies to improve the user experience.
Software Elegance
  1. Software Elegance


Software Elegance

Jakob Jenkov
Last update: 2019-03-24

Software Elegance is my term for the functional elegance of software. In 2008 I was studying software usability extensively, and I came up with a short set of guidelines for achieving functionally elegant software. In fact, I formalized these guidelines in a small project about Software Elegance which was my last project during my Masters in IT from ITU in the autumn semester of 2007.

In the years since I formalized the guidelines they have been very helpful for me when designing software, both GUI, services and APIs. Plus, these guidelines have been really helpful in evaluating third party software. The guidelines immediately give me some dimensions along which to evaluate the software. Having benefitted from these software elegance guidelines for a long time they have proven themselves useful, so I decided to share them with you.

Elegance Defined

Before I list the software elegance guidelines I want to more clearly define what I mean by elegance. By elegance I mean:

Making something hard seem easy, almost effortless.

This is what a ballet dancer does when standing in a very difficult and physically demanding position, as if it was the most natural, effortless position to stand in.

This is what a free climber does when climbing up a vertical cliff as it if was a regular latter.

Functional, not Aesthetic Elegance

It is important to underline that I am talking about functional elegance and not aesthetic elegance, when I am talking about software elegance. First of all, software aesthetics have a tendency to change over time, like the clothing fashion industry. Today flat icons are cool, tomorrow 3D icons are cooler etc. Software aesthetics also seem to be more subjective. This tendency to change and to be more subjective makes it hard to say anything objectively true about aesthetic software elegance.

Second, I am not educated in graphical design so I am not really that well equipped to pass judgment on aesthetic elegance as it is.

Of course, you cannot completely seperate function and aesthetics. A visually clear and appealing user interface will naturally feel more functionally elegant too. However, my focus is still on functional elegance.

Software Elegance Guidelines

The software elegance guidelines can be summed up in a single sentence:

Solve my problem, with minimal effort from me, and don't get in my way.

As you can see, this sentence defines elegance as how the user feels when interacting with the software. It is a subjective experience, but with somewhat objective measures.

The simple sentence above contains three rules:

  1. Solve my problem
  2. With minimal effort from me
  3. Don't get in my way

I will explain what these three rules mean in more detail in the following sections.

Solve My Problem

The rule solve my problem means that the software must solve the user's problem. When a user has a problem and evaluates a piece of software as a potential solution to that problem, the software will either solve the whole problem, solve part of the problem, or nothing at all.

Often, the problem is not really a single, concrete problem, but rather a problem space. For instance, reading data from, and writing data to a database. Or keeping track of a project. Or optimizing investments for bank clients. Or enabling users to connect and communicate.

Inside a problem space there are typically many smaller concrete problems to solve. The more problems of the total problem space a given piece of software solves, the better. The more it will feel like the software "solves the user's problem".

With Minimal Effort From Me

The rule with minimal effort from me means that the problems the software solves should be solved with as little effort required from the user as possible. As little looking and reading, as little moving of the mouse, as few clicks and as little keyboard typing as possible. In other words, as little mental and physical effort as possible.

Requiring minimal effort from the user is when software goes from feeling like a "tool that gets the job done" to feeling elegant. The easier it is to get the work done with a given tool, the more elegant the tool will feel.

Don't Get in My Way

The rule don't get in my way means that the software should not make it impossible or disproportionately harder to solve some of the problems in the problem space. You may think this rule is obvious, but I have often seen software (both APIs and GUI apps) that were so focused on solving only one part of the problems in the problem domain, that other problems were completely unaddressed.

As example, imagine a JSON parser which can only parse JSON into Java objects, but in your case you do not really know what the JSON looks like ahead of time, so you cannot really create a Java class to represent the JSON. Such a JSON parser would solve the problem of parsing JSON into Java objects, but prevent you from parsing JSON into a more dynamic structure - which is what you need in this case. Such a JSON parser would "get in your way". It only solves part of the problems in the problem space, and it prevents you from solving other problems in the problem space (unless you supplement it with yet another JSON parser).

Software Elegance is an Iterative Process

Achieving elegance in your software should be an iterative process. Do not try to make your software 100% elegant from the beginning. Doing so would result in delayed releases. Instead it is often better to improve the functional elegance aspect from release to release, just like you would with any other part of the software.

Additionally, getting feedback from users is also necessary. Users will tell you what they think could be made easier, or what problems your software is causing, or is not solving etc. To take this feedback into consideration you need an iterative approach to implementing functional software elegance.

Jakob Jenkov




Copyright  Jenkov Aps
Close TOC