Bookmarked: On Writing Documentation // Take on Rules
Once upon a time, I said outloud “If I ever get a tattoo it will say «The Docs Lie».” This was a response to a colleague asking that we collecively should write more documentation.Two years later I wrote Code is a Conversation. At the time, we were working in a highly volatile code-base. I found it draining to even think about taking time to write documentation. Writing documentation, like writing tests, means considering what is the context of what you’re writing.