web analytics

Good technology writing doesn’t come easily. Not at first.

Most people can usually produce simple, straightforward copy even if they’ve little experience. That’s the best place to start.

After that, good technology writing boils down to understanding your subject matter and thinking clearly — then turning your thoughts into words.

If you can do this in a logical fashion, the overall shape of your story will leader the reader through the key points.

Start with simple technology writing

Start by sticking to basic words and simple sentence structures. Don’t worry if it feels like plodding. You can experiment when you feel more confident.

Inexperienced technology writers often have one of three faults:

  • A pompous and overbearing style. Avoid this by being friendly, although not too chatty. And use active language.
  • Too technical. By this I mean it does not explain technical aspects clearly enough to non-experts. Fix the problem by keeping jargon to a minimum and explaining tricky ideas in simple terms. Don’t worry if  this makes your writing longer.
  • Trying to be cute. There’s nothing wrong with making jokes or using everyday speech, but beginner writers often take this too far, to the point where understanding their meaning is hard.

Hit the right note

Pitching your copy at the right level is the hardest part of technology writing. Experienced technology writers know no one ever succeeds in this business by overestimating the reader’s intelligence. They also know no one succeeds by underestimating readers.

Remember people who are expert in one area of technology, may not automatically understand other areas. And a technically literate readership does not give one a licence for sloppy explanations of complex technical matters.

If you find this difficult, imagine you are writing for an intelligent colleague working in another area of your organisation.

  • Picture that person reading your words.
  • What questions would they ask if you were in the room with them? Make sure your text answers these questions.
  • Have you written something they would find patronising? Hit the delete button and make that point again.

Lastly, always get someone to proofread your copy.

Ask them to point out what doesn’t make sense and to see if you’ve made any obvious errors. Don’t take offence if they find lots of things that need changing, your pride will be more wounded if the rest of the world saw your mistakes.

Update: I’m indebted to Thomas Beagle for reminding me about bullet points. Like the man says, use them where possible to break up block of text and make your writing easier to navigate.

4 thoughts on “Technology writing for beginners

  1. I’d also add: replace paragraphs with bulleted and numbered lists as often as possible.

    (I note your own use of bullets in your article!)

  2. @Thomas – That is a really good point. I’m going to edit it into my story.

    Ten years ago I would have argued against lots of bullet points – especially in printed media like newspapers or magazine – because they break a reader’s flow.

    In online writing, breaking up block of text with lists makes material easier to navigate.

  3. How do you start getting products to test? Why would some one approach me – even if I work in ICT industry – hardware specifically?

    • @Swapneil – That’s putting the cart before the horse, you need to establish yourself as a writer first. If I was heading in that direction, I’d start by writing lots of reviews of free or low cost software and building up an audience before asking for review products. Alternatively become established as a technology news writer first.

Comments are closed.

%d bloggers like this: