
Clean Code Metaphor for Good Writing

#48 - Communicate to Become a Happy & Productive Engineer - Chris Laffra
Topic 6 of 11
Published Jul 26, 2021 · Clip 28:24–31:00 (2:36)
Building on the host's refactoring metaphor, Chris compares writing docs to writing clean code: break documents into small paragraphs with titles, just like small, well-named functions. He urges engineers to invest in vocabulary, grammar, and sentence structure the way they invest in understanding language features like list comprehensions vs for-loops. He shares his own example of training himself to pause instead of saying 'uh', showing how deliberate practice turns communication investment into intuition.