News for hackers. Stuff that matters.
Re:Ask HN: How to level up your technical writing? by vnorilo on Saturday June 25, 2022 @07:27AM (#31874344)
Their style guide [1] is one of my references when trying to improve my own writing.

While my professional writing has been mostly academic, I find the progression is similar to tech writing.

First you learn to show your erudition and command of the ingroup speech.

Then, if you have a genuine desire to communicate, you progress to simpler yet precise language, stop using the big words when not necessary (often, they are just signaling and gatekeeping) and develop empathy for and understanding of the audience.

1: https://cdn.static-economist.com/sites/default/files/store/S...

Re:Ask HN: How to level up your technical writing? by mif on Saturday June 25, 2022 @08:27AM (#31874689)