The long way through Software Craftsmanship

The Senior Software Engineer, Chapter 9

May 28, 2017 - 1 minute read - Comments - bookreadingsenior-software-engineer

Chapter 9: Learn to Write

Analogy of TDD to writing.

Explains how to write good email. Then, good documentation, then good API documentation

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

Posted by Alvaro Garcia

The Senior Software Engineer, Chapter 8 Self-Study in June 2017