[Randgalt]

Tech writing is a specialty. It's a different skill set than coding. Unfortunately, it's the devs who write the docs these days and they're not usually good at it.