Swimming in Tech Debt

9 loumf 6 9/5/2025, 5:33:03 AM 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.

Comments (6)

bee_rider · 1h ago
You think it is the first half. You’ll realize later on that really you need a totally different structure to write the book. You’ll try to refactor the whole thing, but some obstinate subset of the original readers will insist on using the original index. In the interest of backwards compatibility, you’ll jam the new structure into the margins (so they can keep their precious index).

It’s text-debt.

protocolture · 1h ago
DNR'ed pretty quickly.

You seem to be writing about other concepts and just redefining them as tech debt.

I left more detail in comments, but if I had purchased this book I would be seeking a refund, because I would be expecting a detailed exploration of technical debt, not just a focus on bad coding practice.

mdaniel · 21m ago
I'd recommend resubmitting as Show HN since this is your product and those submissions actually have their own dedicated URL. Plus, the way the title reads now is as if the submission was a blog you found
brudgers · 1d ago
Congratulations on writing a book and getting it out in the world.

1. It took me two tries to realize there is more than the table of contents and find the Unlabeled links on the left. Just make the text in the TOC clickable.

2. Maybe text navigation didn't work the first time because I did not select the correct option on the popup about interaction. This is a distraction from reading irrespective of what I picked.

3. Advice: make the reading experience work like readers expect. There are conventions. Trying to be clever doesn't benefit your readers...and will annoy at least one of them.

4. Nobody likes popups. Nobody. Nobody.

Good luck.

withinrafael · 1h ago
Thank you for writing down and sharing your experiences and insights, and making it accessible for just a mere buck.
Sn0wCoder · 2h ago
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!