3 ms·
If that were the case, then programmers would have fantastic documentation skills. And yet, by and large that's not the case.
by kylemaxwell 13y ago
If that were the case, then programmers would have fantastic documentation skills. And yet, by and large that's not the case.
- platz 13y agoAgree - I tire of the grammar used by techies and programmers which, even writing in their native language, sounds like one of a 2nd-year foreign immigrant. They cannot (or care not to) empathize with how a reader might interpret their words.
- kolinko 13y agoGood documentation takes effort. I bet much of the docs are lousy because of laziness or poor priorities. Apart from that, the question is not whether the documentation is good or bad, but whether it's better or worse than the one a non-programmer would write. Finally, even apart from writing skills, programming teaches you how to comprehend what you're reading (docs), and how to solve problems.