Opsitive"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")
Billy Smith@BillySmith See also “I must have been drunk or something. Let’s make this proper.”
<2 hours later>
“Oh that’s why I did it that way…”
<2 hours later>
“Oh that’s why I did it that way…”
It's the tacit knowledge that never gets recorded in the docs.
"Why would i need to write that down? It's obvious!" :D