2 ms·
> You end up writing a tremendous amount of documentation that is really ephemeral Yet I find that writing more about what I’m doing (most commonly in the form
by chrismorgan 8y ago
> You end up writing a tremendous amount of documentation that is really ephemeral
Yet I find that writing more about what I’m doing (most commonly in the form of extensive code comments and verbose commit messages, but also in other forms) helps me produce better work.
Time and time again I explain in writing how something is or why it’s done the way it is, and realise in the process substantial ways in which it might be improved; or how it’s actually completely broken for an important case that I hadn’t considered; or any number of other reasons why further work is desirable.