I'm Matthew Setter. I'm an experienced software engineer and a security researcher. I’ve been developing software since 2000 and I started this blog to help you write simpler, cleaner, and more secure software, with less effort.
5 Steps to a Great Tech Postwriting October 14th, 2014
In this post you'll learn what it takes to write a great tech blog post — in 5 simple steps.
Tech is something I never get tired of. Whether it’s new software languages, new hardware, new tools or new concepts, it’s in my blood. But just because it’s in your blood doesn’t mean you can write about it.
Don’t believe me? Think of a handful of people you know, who are good, or at least, very, passionate about what they do.
Now of that list, would you ask any of them to tell you about what they do? How many would put you to sleep? How many would talk over your head — almost immediately?
Whilst well meaning, and very capable, most techs (geeks and nerds are also applicable terms too) just can’t communicate that well. Sorry folks, but I have to be honest!
When I say I’m a freelance technical writer, with over 14 years of software development experience, people are so often amazed that a developer can communicate and teach what they know.
It’s much more common place for developers to have no desire to communicate, to take forever to compose their thoughts, or just completely miss the mark when attempting to do so.
My brother refers to what he commonly hears from support staff as “Talking in Modem”. I didn’t quite know what he meant when he used the term. He clarified by saying:
You know that noise the old modems made when they’d connect to the internet, that squeaking sound at various pitches? Yep, that’s what it sounds like a lot of the time
So today I’ll show you what it takes, even if you’re a tech, to write a great tech blog post; in 5 simple steps. Consider it a crash course.
1. Be a Storyteller
If you don’t have this skill, or are unwilling to develop it, the rest doesn’t really matter. Yes, you can explain step-by-step how something works.
But that’s not teaching, it’s not communicating. This approach doesn’t really help someone truly learn.
You have to be a storyteller.
You have to wrap up tech in a story which draws people in, then hooks them, taking them along for the ride, engaging their imagination.
To help you start off, ask yourself the following questions:
- What problems are people trying to solve with this tool or language?
- What pain will this technology, tool, or language solve?
- How will it make their lives easier, less involved, even simpler?
- How well they benefit from it?
In short, look for the benefits, not the features. Find the hook then craft your story around it.
2. Focus on one Topic
This is the next most essential skill to master. Tech’s one of those gorgeous subjects where, if you’re not careful, you can attempt to talk about too much.
Everyone seems to want to know everything, especially about anything new. Fine if you want to, but you’ll lose your reader; lose them by making it too damn hard to stay focused on all the things you’re trying to cover.
Don’t do it. Instead pick your topic, one topic, perhaps along with some minor, supporting, one and focus right in on it, bringing it to life in full technicolor.
3. Be Clear and Specific
If there’s one thing that technical people don’t like it’s waffle. We’re the kind that like to get to straight to the point, get the facts, know what’s going on. So for that reason, you have to know and respect your audience.
Sure, tell a story, but take more of a Hemingway than a Shakespearean approach. Build the scene, but not at the expense of the facts. Use a story to bring out the tech core, not to obfuscate it.
4. Be Timely
Another thing about tech, which I’m sure we’ll all agree on is that it changes so damn fast. So make sure that what you write about is timely.
Don’t talk about outdated software versions or previous software releases. Like everything there are exceptions, such as historical or yearly reviews.
But for the most part, make sure your finger’s on the pulse. Talk about up to the minute topics, like the latest version of Android, iOS 8 and OS X Yosemite (latest at the time of writing).
Demonstrate that you stay up to date with what’s going on.
5. Make Sure it’s Accurate
Here’s another essential — if there’s one thing which can sink you, it’s technical errors. You’ll frustrate your readers no end as they’re trying out code and configuration changes, only to be met with errors.
Don’t be the person who always makes mistakes, who get things wrong. Be the person people can always rely on for accuracy and quality. Be the person who stands out from the crowd and presents information which works, first time, every time.
And that’s 5 tips for writing a great tech post. Take these on board and you’ll definitely gain greater traction with your readers.
Do you have other tips and ideas for great tech content? Share your thoughts and experience in the comments.
Join the Email List
If you enjoyed this post, why not join the email list and get all future posts straight to your inbox? In addition, you'll get background information, extra research, and other content that's only available on the list. I promise I'll NEVER spam you. And you can unsubscribe at any time.