"Tests provide the only reliable documentation of design. The story they tell remains true long after paper documents become obsolete and human memory fails. Write your tests as if you expect your future self to have amnesia. Remember that you will forget; write tests that remind you of the story once you have." (Sandi Metz, "Practical Object-Oriented Design")
@monospace Tests, at least partially, answer the question "What does this code do?", but don't necessarily help answer the question "Why was this code written?", something that a design document can describe and which will continue to remain true because it's a description of the past. No?
Add comment