The long way through Software Craftsmanship

The Senior Software Engineer, Chapter 5

May 23, 2017 - 1 minute read - Comments - bookreadingquotesenior-software-engineer

Chapter 5: Deal With Technical Debt and Slop

  • Seeing legacy as tech debt that has been acquired
  • Slop as source for sloppy code
  • Chapter about understanding the difference between slop and technical debt.

Many developers, if they are feeling pressured to complete their work, would call this an acceptable compromise, promise to fix it later, and ship it

(p. 70)

Technical Debt is […] used to explain compromises in implementation that save cost now, at a larger future cost (just like real debt). […] technical debt is code written under certain assumptions that no longer hold.

(p. 72)

Although you’ll likely need to pay it off someday, you might not necessarily have to.

(p. 73)

Uses a marker (TECHDEBT) to explain what and why has been introduced. Also serves to find this debt later.

Disclaimer about AI/GenAI

As of 2026-05-06, the text in these articles and blog entries has been written without AI/GenAI, except I sometimes use a spellchecker to fix errors. Think Word's spellchecker, not ChatGPT.

Notes, as of today (2026-05-06):

  • No code snippet has been automatically generated, nor vibe-coded, nor generated and reviewed.
  • I don’t have any article with AI contribution.

For future entries:

  • I may have used GenAI for the code in the repo. The code I exemplify/copy in the article will always be reviewed and tested, not vibe-coded. I will specify it in each snippet or at the top/bottom of the article.
  • I normally don't use it for the text contents, although if I have used it for the article text, it would be indicated as such.

Any entry before 2026-05-06 does not contain any AI/GenAI.

For more information, read the AI/GenAI Policy

The Senior Software Engineer, Chapter 3 The Senior Software Engineer, Chapter 6