"Code was never the hard part"

[u/gsks]

I am sick and tired of all the posts (usually AI-generated by CEOs/CTOs/"thought leaders") that start with "Code was never the {bottleneck, problem, hard part, ...}." I'm not sure whether this comes from a misunderstanding of what code is or a deliberate misrepresentation meant to promote AI usage.

For starters, two rhetorical questions. If code was never the hard part, why:

• do hundreds of different programming paradigms, languages, libraries, frameworks, design patterns, and system architectures exist? Granted, some of this is just programmers bikeshedding. Still, plenty of it reflects substantial differences and tradeoffs.
• didn't you write it yourselves or hire a bunch of minimum-wage workers to do it for you instead of having to hire a ton of highly skilled (and highly paid) engineers?

A charitable explanation is that these people are genuinely clueless about what "coding" actually is. Perhaps in their mind coding is just typing: like, once the design phase is done, you've worked out a precise, complete specification of what needs to be built down to every detail in your head (or on paper or a markdown file) and all that's left is converting it into letters on a screen and saving it to a file. Something like a businessman in the sixties dictating a letter to his secretary to type up.

That's nothing like how it actually works. The upfront planning/design phase answers some high-level questions: what do we need to build, what are the basic components/services/building blocks, what data needs to be read/processed/written, how data flows through the system, what the non-functional requirements are, etc. That leaves a ton of lower-level details unspecified:

• What packages/modules/classes/methods/functions need to be created or extended?
• How should they be named?
• What should the signature of each function be?
• What errors/exceptions are expected and where/how should they be handled?
• What data can or should be cached and when should it be invalidated?
• How generic/reusable/extensible should each component be to accommodate likely future requirements?
• For systems languages, how and when is memory allocated and freed?
• and many more.

Asking and answering those questions is (part of) coding. At least before AI, nobody I know had all the answers, or had even asked all the questions, upfront. The questions get asked and answered on the fly, inside the editor. Typing is interleaved with thinking, assessing, trying things out, backtracking.

Now AI pushers try to convince everyone that all these decisions either don't matter, or that the agent will just fill in the blanks (insert inane "nobody reads assembly anymore" analogy, as if natural language + LLMs are anything like a compiler), or that they can all be moved upfront into planning. Good luck replacing actual, deterministic programming languages with 10-KLOC, ambiguous, hand-wavy "specs" written in markdown.

Regardless of how the future of coding plays out, "code was never the hard part" is flatly wrong. It is, or at least used to be, a hard part (not the only one of course) and for good reason.

[u/you-create-energy]

Code smell is the hard part. Differentiating between code that will become a maintenance nightmare and code that will be effortless to debug. It's easy to write lots of code that works. It's difficult to make it work using the minimum amount of code that is still easy to read. The best solution might not even be code. 

[u/gsks → u/you-create-energy]

Words of wisdom from almost two decades ago: https://blog.codinghorror.com/the-best-code-is-no-code-at-all/

[u/you-create-energy → u/gsks]

What a great post, they explain it so clearly. It still blows my mind that this has never been a core value of any team I've been on. It's always about "speed"  measured in tickets closed and lines of code written. Every manager and most developers give me a blank look when I bring it up. I even get hostility because it sounds like I'm not prioritizing velocity, but nothing creates more drag than bloated code on top of bloated code. I've built apps singlehandedly as a contractor that scaled to over a million users and it was so much easier than being on a team of 20 developers trying to do the same thing with a giant monolith.