Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

I've developed my skills by writing documentation, presentations, blog posts, in-depth articles, and Stack Overflow answers. I always start out by thinking about who my audience is and why they're reading what I wrote, and I always finish by trying to cut down the material I've written so it doesn't contain anything unnecessary.

In technical writing, clarity reigns. Clarity above all else. Lists? Use bullet points. Topics? Make headings. Do two terms seem similar? Change your wording to make the differences obvious. Is there a technical term? Use it consistently. Are you using the same word in different senses? Use two different words. Using negatives? Use positives instead, they are easier to parse.

If you are good at the details of writing, your thoughts and ideas become clearer, because clear writing exposes the flaws in your ideas.

Recommended book: Style: Lessons in Clarity and Grace.

I also recommend finding a topic to blog about. You don't need to be an expert. Just keeping an active blog teaches you a lot about writing.



Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: