Should you code well or code fast?

Sarcasm aside, the most telling line was this one: "If the project is for a three-month campaign that must be completed next week, the shortest path to the finish line is probably best. I've only been a developer for five years, and 95 per cent of my professional projects are [like that]."

This essay was written by a developer at BKWLD, an "independent digital agency." They do a lot of advertising work. Of course code quality doesn't seem important! Code quality matters when you have a team of people developing and maintaining software over a long period.

Here's a more nuanced view: speed matters, and you can be really successful developing important, business-critical software by emphasizing speed over quality. If it's a problem domain you're particularly familiar with, especially if you have a lot of tools, frameworks, and libraries to help you, you can get an impressive amount of work done.

As you continue to work, you'll slow down. At some point—about six weeks is my guess—you'll actually be going slower than someone who's focused on quality. They'll speed up over time (asymptotically), and you'll continue to slow down (also asymptotically). You'll still be ahead of them, though, because you got so much done in that initial burst of energy. Your life will start to suck, though, and you'll be looking forward to when the project is done.

Eventually—about three to six months, I'd guess—you'll fall behind. You'll be going so slow that your initial advantage will have been erased. Luckily, you now get to hand the project off and start a new one. Win!

Three to seven years later, your code will be thrown away. It will be so expensive to change that it no longer makes economic sense to maintain. If it's still relevant, it will be rewritten at great expense and even greater opportunity cost.

So, does quality matter? Depends on who you ask... and who ends up paying for it.

Words like 'clean', 'elegant', 'well-structured', even SOLID are qualities of objects we want to consider at a distance, like statues or paintings. They are words of repose and reflection. You know: business death.

Here's an example from this essay:

"There is a reason good code is considered to be a form of poetry. It's elegant, clean, easy to read, and fun to write. These are all exceptional qualities that we should strive for every single day."

Try telling a product manager or CEO or other stakeholder how 'clean', 'easy to read', or -- God forbid -- "fun!" your code is, and watch their eyes roll back in their head. (I exaggerate for effect.)

These ideas make sense to us as developers because that's what we spend our entire day doing: considering, reflecting and thinking about code. But I think what we should be talking about is the inherent speed of the codebase. I'm not talking about my velocity as a developer, or the velocity of the team and how many story points they deliver per sprint, but the inherent velocity of the codebase as a function of its technical debt. Codebases, from a business standpoint, should not be "clean" or "dirty", but rather "fast" or "slow".

Technical debt should be surfaced to the stakeholders using language that conveys the dollar value, the fiscal liability, of technical debt. The most accurate way to describe that and show how debt is slowing your team down, is to talk about its inherent speed.

"Our codebase is getting slower" makes business sense to a Product Manager. "Refactoring this will make our codebase faster" is a phrase that conveys the worth of initiatives that otherwise seem to have no immediate effect on the bottom line.

All of the tools and agile methods we have talk about velocity in terms of what a team is delivering, and can parse that down to the sprint and developer level. But in my experience, the most significant contributor to a team's relative speed is the (intertia|speed|velocity|momentum) of the codebase itself, as a function of its technical debt. I think we need to start using language that intuitively and constantly surfaces the dollar value of technical debt to the stakeholders, so that "just ship it!" no longer sounds like a sound business strategy.

Just use your brain, use your judgement on the result, make a decision, iterate.

When your code sucks or you intentionally code fast you end up adding tons of things that will drag you over and over again. And unavoidably you'll end up asking yourself "why didn't I code well. I would have ended up much faster".

Though worse code benefits the most by having well-enough made Comments.

"Code is usually read more times than it is written."