
Clean Code disagreements: methods, TDD, comments

The Philosophy of Software Design – with John Ousterhout
Topic 12 of 15
Published Apr 9, 2025 · Clip 55:49–1:10:40 (14:51)
John details his disagreements with Robert Martin's Clean Code. On short methods: shortness is not the goal—depth is; excessive decomposition creates more interfaces and entangled methods, making systems more complicated. The host parallels this with Uber's move from 5,000+ microservices to midsize domain services. On TDD: John loves unit tests but argues TDD encourages tiny tactical increments and specialization, working against design; he concedes writing tests first helps when fixing bugs. On comments: he disagrees with 'code should speak for itself'—interfaces especially need comments—and notes AI tools like ChatGPT can partially compensate for missing comments but shouldn't excuse not writing them.