Comment by raincole

5 days ago

I've seen developers who genuinely like to write code, but never met one who likes to write documents. I know they exist somewhere, but I'd not judge someone's programming ability/willingness by their English writing ability/willingness.

I like to write documents. It helps me understand the code much better, as I'm forced to write down what's happening at each stage. Yes, code itself can be self documenting, but writing it in English can elucidate any hidden assumptions.