How to Write Clear Tech Articles (That People Actually Read)

feature-image

Play all audios:

Member-only story


How to Write Clear Tech Articles (That People Actually Read)Andrew LongFollow5 min read·Sep 21, 2020 --


Share


I feel like I’ve been writing just long enough to have figured out what works for me, and what really, really doesn’t. I write primarily technical articles dealing with programming and


security — you know, really exciting stuff. Writing tech articles is such a weird balancing act that can so easily fall flat, making you sound either dull or uneducated on the subject. I'm


going to talk about some of my own observations, and the many ways I’ve discovered that one can fail.


Research all the things I rarely go into an article without either real-world experience or hours of research. Often, it’s both. I don’t care if I’ve worked with this technology for 2, 5, or


10 years — I’m going to research everything before I start writing, and keep it up while I’m writing. Maybe it’s my own insecurity, but I’m just not comfortable stating anything as the


gospel truth without checking the facts first.


I don’t usually do it this way This hasn’t always been the case. In my early days of writing, I would sit and type out an entire article about so-and-so subject completely from memory and


life experience. While there’s something to be said for sharing…