Hacker News new | ask | show | jobs
by mshron 2236 days ago
Great question. Writing skill is generally underdeveloped in engineers, and it's absolutely worth getting good at.

Based on your other comments, you're already starting with drafting, which is great. The next step is to learn to revise well so you feel more comfortable with your early attempts and don't need to toss them out.

The book _Style: Lessons in Clarity and Grace_ by Williams and Bizup is about how to rework a draft into something more coherent. They talk about revising sentences, and paragraphs, and then whole structures to be as coherent as possible.

Once you have a mental model for how people read, and what makes reading easier or harder, it's easier to get into the habit of writing and revising. Then you get stuff out of your head and revise it until it's in a form you're happy with. Rinse and repeat.