Technical Writing Made Simple, Stupid

by | Oct 17, 2012

You’re a reasonably bright person, right?

So, why does technical writing make you feel so stupid?

Does this sound familiar?

  • The how-to manual forgets to tell you how
  • Legislation crushes you in cross-references
  • Contracts bind you in legalese

All forms of technical writing?

My definition of technical writing may be different than yours.

Technical writing provides and explains details for specific subjects.

  • It could be the software manual we all think of when we hear the term
  • It could also mean a marketing ad that is trying to convince you why you need the next X-GREAT-!2

Even rocket science does not need to sound like rocket science.

Removing the Huh?

The following are simple tips for taking the Huh? out of technical writing.

If you are a regular reader of this blog, you know where the tips are headed.

#1 – Keep it simple.

Like any writing, the first question is – who is your reader?

  • A professional from the same industry?
  • End-users with varying skillsets?

While an article on a scientific study has a different style from a software manual, both benefit from a simple approach.

Keep technical writing logical.

  • If instructional, provide steps and number the steps
  • Break longer instructions into sections – e.g, Download, Activation, Settings
  • Allow each section to stand on its own – not all readers need the same detail

If promotional, use Your Litmus Test for Successful Marketing, which responds through the eyes of your reader.

  1. Who are you?
  2. Why should I care?
  3. What problem(s) are you going to solve for me?
  4. What makes your product/service different from any other?
  5. Prove it.

Responding to those five elements keeps your writing simple and focused.

#2 – Keep it clear.

The funny thing about this style of writing ~

  • When you want more detail (like an explanation of a function), it’s missing
  • When you could use less, you are buried in details

Share relevant information.

  • If a screenshot promotes a clear understanding, use one
  • Review content for unnecessary data and eliminate it

 Use formatting techniques that complement your message.

  • Bold action items
  • Design for easy scanning
  • Consider moving tables and charts to an appendix

Stay focused on your message.

#3 – Keep it uniquely yours.

Do you have a favorite author whose style is instantly recognizable?

We all have qualities unique to us – our own style – use that to your advantage.

Technical is not synonymous with boring.

  • Interject humor where it makes sense – and if you’re good at it
  • Make the complex simple – educate and guide others to understanding
  • Share your passion for the subject

Go Forth and Educate

The objective of most technical writing is education.

Understand your audience and then ~

  • Keep it simple
  • Keep it clear
  • Keep it uniquely yours

What tips do you have for this form of education?

====================

Helping you Keep it simple, clear & uniquely yours – contact me for help with your business writing needs.

=====================

BigStock Photo Credit

 

6 Comments

  1. Laura Spencer

    You caught my eye here Cathy, since I worked for over a dozen years in the corporate world as a technical writer.

    Your post does a great job of explaining what we strived for in the technical writing departments where I worked.

    Unfortunately, many technical documents are not written by professional writers at all, but by the subject matter experts (such as engineers or programmers). That’s often when they become boring or difficult to understand.

    Reply
  2. Sharon Hurley Hall

    I especially love “technical is not synonymous with boring”, Cathy. There’s a story in everything. If you can find the element that people will relate to, then half the battle is won.

    Reply
  3. Cathy

    Well, I am glad I was able to catch your professional eye, Laura. 🙂

    My technical writing is my healthcare/insurance niche. I’ve seen exactly what you’re talking about – especially when it came to legislative compliance issues.

    You bring up a very good point – consider WHO is the best resource for writing the content.

    Thanks for sharing your thoughts, Laura.

    Reply
  4. Cathy

    Oh, Sharon, I love There’s a story in everything. Exactly!

    Thanks for that great perspective, Sharon.

    Reply
  5. Anne Wayman

    When I was tech writing, in the early days of home computers, I made up a rule for myself that said no more than 5 steps at a time. Found I was always able to chunk it down… now, if I’d only added story too.

    Reply
  6. Cathy

    That’s a great rule, Anne. And I love the story idea.

    Reply

Leave a Reply to Cathy Cancel reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Pin It on Pinterest