Top
Best
New

Posted by loumf 9/5/2025

Show HN: Swimming in Tech Debt(helpthisbook.com)
This is the first half of my book, “Swimming in Tech Debt”. It is available at a pre-launch sale price of $0.99 (https://loufranco.com/tech-debt-book).

I have been working on it since January 2024. It is based on some posts in my blog, but expands on my ideas quite a bit.

In September 2024, excerpts appeared in Gergely Orosz’s Pragmatic Engineer newsletter, which helped me get a lot of feedback that expanded the book from my initial idea. This half is about what I expected to do before that —- the rest of the book goes into team and CTO practices.

167 points | 73 commentspage 2
withinrafael 9/5/2025|
Thank you for writing down and sharing your experiences and insights, and making it accessible for just a mere buck.
loumf 9/5/2025|
No problem. I hope you find some useful tips in it.
sltr 3 days ago||
I think tech risk is a better metaphor than tech debt. https://www.slater.dev/its-not-tech-debt-its-tech-risk/
giulianob 9/5/2025||
I read the first part and I enjoyed it. I agree that us developers aren't great at communicating tech debt effectively. Managers are also not great at prioritizing it. I think the "debt" analogy has been a net negative as management often thinks "we'll just pay it later" but don't often see how much pain it's causing. So having a resource to help both sides on this topic is very valuable.
loumf 9/5/2025|
Thanks. That’s my belief as well. I would have loved to come up with a better term.

In the next two parts of the book I try to convince managers to give some autonomous time to engineers to do whatever tech debt projects they think is best. With some constraints and accountability.

giulianob 6 days ago||
I'm having this exact conversation with senior leadership in my team. I'm looking forward to it and I might do a book club reading when it comes out!
timwis 9/6/2025||
Any chance you’re selling the ePub format directly, or via the Kobo store? I switched from Kindle to Kobo a few months back, when Amazon decided to remove everyone’s ability to download the books they’ve purchased. But I’d love to read this!
loumf 9/6/2025|
My priority is Kindle, then print. Then I will look into other formats. At that point I will have a PDF (that was used for Print) and an epub, so it will primarily be driven by interest.

The best way to be notified by it is to be on my list at loufranco.com or reaching out to me.

brianmcc 9/5/2025||
A total tangent but it's amazing how more palatable "tech enhancement" is in planning, management chats, etc., than anything involving the term "tech debt"
cadr 9/5/2025|
Can you say more on your experience here? I've not heard people use that term before, and I'd be interested in how it received/what you think the difference is.
brianmcc 9/5/2025||
Sure, just that stories about "paying down tech debt" are an implicit admission of flaws and shortcuts and "doing it again because it wasn't done right initially".

Which is all true but the concept of making deliberate trade offs for speed and expedience invariably gets lost.

Stories about ongoing improvement - tech enhancement - just get seen as more positive. Plus that term covers both remediating original shortcut choices as well as new engineering improvements arising.

cadr 9/5/2025||
Thanks!
ChrisMarshallNY 9/5/2025||
I wish you luck, and you’ve picked a good subject.

I once wrote a book (about 400 pages, after editing). No one read it, and rightly so. It covered a topic in a preachy, dictatorial manner. It’s long buried in a deep, unmarked grave, in the desert.

It was accurate, well-written, well-structured, relevant, and useful, but assumed a tone that was pure poison. It was aimed at an audience that did not respond well to the tone.

It was extremely valuable education for me, though. My mother was a scientific editor, and edited the book. It was brutal, and quite humbling, but her work ensured that the book was absolutely perfect. I don’t think I’ve ever shipped anything as close to [unpopular] perfection as that book.

Even though I have never been particularly interested in writing book-length stuff, since then, I continue writing to this day[0]. Here’s the latest thing I did (released a few days ago)[1]. I don’t really write for others; I write for myself.

Good luck.

[0] https://littlegreenviper.com/miscellany/

[1] https://littlegreenviper.com/series/passkeys/

[EDITED TO ADD] I typically get some downvotes, when I link to my postings. Long ago, I favorited a comment that I made, explaining this[2]. I don’t expect anyone to actually read it before hitting the down arrow, but I figured that I’d add it here, for elucidation.

[2] https://news.ycombinator.com/item?id=31860143

loumf 9/5/2025||
I do wish HN had a culture of being ok with linking to supporting material on our own sites. I have been blogging for 20+ years -- some of those posts are relevant (and I think useful).

I also mostly write for myself, but I want to get more of it out there because I think it's useful.

ChrisMarshallNY 9/5/2025||
I sincerely wish you luck. As I said, I think it's a timely topic.

I didn't know helpthisbook existed. Interesting service.

As you may have noticed, people are conflating the HTB stuff with your material, and HTB should keep that in mind.

I have found that talking about improving software Quality is a deeply unpopular topic, on HN, and that kinda breaks my heart.

fakwandi_priv 9/5/2025||
Refreshing to see a potential conflict[2] get solved in a civilized manner, rare these days. Thanks for including it.
osmanthegreat 9/5/2025||
It's a good topic and I am currently trying to manage lots of tech debt. So it caught my attention and I started to read, but it seems that you liked your swimming upstream allegory a little bit too much. Basically reading the same sentence several times in every chapter bored me and I quit...
loumf 9/5/2025|
Sorry to hear that. Fair.
Sn0wCoder 9/5/2025||
Thanks for the link. Its always helpful to have new ways to describe tech dept. The term is too overloaded and most people roll their eyes when hearing it since it can be used to describe anything from real issues to things that are fine but you just do not like for whatever reason. Look forward to reading the section on what issues are worth paying down and those that are fine to live with. Its not any easy decision to make, but having concrete examples is always a bonus. For .99 cents pre-ordered a copy and if there is going to be a real book would love to have it sitting on my desk. It could sit next to Software Estimation by Steve McConnell ;) Cheers!
loumf 9/5/2025|
There will be a print book about a month after the Kindle version launches. It takes time to get the formatted properly (using a contractor). It will be offered for the Amazon minimum price to start -- if you want a notification, sign up on my site: https://loufranco.com/tech-debt-book.
realaaa 9/6/2025|
will check out your blog ! cheers and good luck
loumf 9/6/2025|
Thanks. I hope it’s useful to you
More comments...