Cover image for Technical Debt is Not Just Technical

Technical Debt is Not Just Technical

remotesynth profile image Brian Rinaldi Originally published at remotesynthesis.com ・3 min read

I'm going to admit something kind of embarrassing here. Looking back on my career, I believe that there were times relatively early in my career when I was probably difficult to work with. I believe I've learned from those mistakes. Let me explain.

Technical Debt

Developers often refer to the concept of technical debt. Essentially technical debt is the "cruft" that gets leftover in an application due to some poor initial decisions about how it was built. These choices are sometimes made deliberately and sometimes unintentional. The thing about technical debt is that it often builds upon itself - poor choices initially limit the choices down the line so that it can ultimately become extremely painful, difficult and, yes, costly to correct.

The other thing about technical debt, it is often much easier to see when you are new to a company or project - especially the unintentional kind.


So, here's me, circa 2005 or so, armed with the confidence of some years as a developer under my belt. My newness to the companies (yeah, I bounced around a bit at this time in my career) made it relatively easy to recognize technical debt. From a technical standpoint, I had enough knowledge to diagnose the issues.

But here's the thing about technical debt which I only learned through years of painful experience - despite its name, technical debt is not just technical. It is organizational, institutional, political and, yes, often personal.

Behind every bit of technical debt, there is a story. Sometimes the story can be simple like, "Oh crap! I didn't realize it should be done this way." More often though, there is a much more complex story that involves people whose egos may be on the line, organizations who pushed for solutions for reasons that aren't technical (an example would be "dogfooding" or software choices mandated by a purchase a senior manager made from a buddy). Sometimes technical choices can be wrapped up in such a complex history that it can become difficult to unravel exactly how the choice was made.

The other infinite loop that all coders fear

The point here is, 2005 me had learned enough to diagnose and, perhaps, even fix these issues at the companies I was joining from a technical standpoint. Armed with technical knowledge I jumped in head-first only to land on powerful blockers that were not technical in nature. My failure was in not being able to see and diagnose the non-technical aspects of the technical debt and this failure left me often frustrated.

Learning to Listen

Basically, I had a "code first ask questions later mentality" when the answer was simple - take the time to ask questions and listen. Find out why certain choices were made. Doing so gives me the knowledge I need to diagnose the technical problem (and to my surprise, sometimes better understanding the non-technical reasons made me realize I was actually misdiagnosing something as technical debt). But, more importantly, it enabled me to offer solutions that work not just from a code standpoint, but work for the people I have to work with and the company I am working for.

Remember that asking questions and listening takes time and patience. You cannot come in thinking you have all the answers, as I did. The best analogy I can think of is going to a doctor to treat pain. The doctor can quickly treat the symptom and the pain will subside, but can leave the problem to fester undetected. However, a good doctor will take the time to understand you, your issues and investigate the underlying causes of the pain and treat it holistically. Be the good doctor that circa 2005 me was not.


Editor guide
stilldreaming1 profile image

Yeah if you want to prevent management (anyone above you) from forcing you into more/continued technical debt, you need to learn how to manage your managers, but in a very sincere way. The best approach is to be good at your job, a good listener, responsible, trustworthy, proactive, respectful, and considerate. The more you practice this, the more management will trust you and respect the stance you take against technical debt. Take a personal interest in satisfying your managers and others needs. For example you might take on and quickly complete one of their simple pet projects that they really want for some reason but have a hard time justifying mandating it as a priority. The more you give them, the more you will get in terms of freedom to do things your way, etc.