3 ms·
Very interesting read. I especially like the following quote: I figured if I couldn’t explain something clearly in documentation, nobody was ever going to unde
by mfonda 13y ago
Very interesting read. I especially like the following quote:
I figured if I couldn’t explain something clearly in documentation, nobody was ever going to understand it, and it probably wasn’t designed right. And once something was in the documentation, we knew both what to implement, and why we were doing it.
I think this a great practice to follow. I often find it very helpful to write documentation before writing code. I find I end up with a better designed system this way, and as an added bonus it has great documentation too.