logoalt Hacker News

repelsteeltjetoday at 9:17 AM0 repliesview on HN

Nope, sorry. I known I'm not good at it.

I suppose it's primarily a matter of experience. And as the article alludes, it's very important to deeply understand the subject matter. I highly value some of my non-programmer colleagues responsible for documentation. But can't put my finger on what exactly they brought to table that made their prose exceptionally good (clear, concise, spot on)...