Just the other day, I was helping out a friend put together a sales kit for potential clients. She felt totally at a loss, since she hardly got support from her boss, who basically just asked her to pull something out of thin air by the end of the week.
As a media and marketing consultant for several clients, I’ve noticed that this is not an uncommon occurrence: junior execs suddenly being thrust into a technical writing role, and expected to deliver results.
While I have only recently hired myself out as a digital mercenary, I’ve been in the business of technical writing for almost 10 years, having done all kinds of operations manuals, sales reports, marketing presentations, concept papers and training materials.
I have to admit, I had to learn quickly on the job. But it was a good thing, because it gave me the confidence to do what I’m doing now. I feel that a lot of people can benefit from what I’ve learned over the years, which brings us to today’s topic.
Effective Technical Writing
As a designated technical writer, your main goal is to make information not just understandable, but also usable. The end result is that your target audience can perform a desired action or make an educated decision based on what it is you just wrote about.
Remember that technical writing falls in the realm of so many industries, not just hardcore sciences and technology. You might find yourself writing a travel guide, a recipe, an annual business report, a guide to buying cameras, indoctrination materials for your colleagues, or even game FAQs.
With that in mind, you can observe these ten simple tips to be more effective as a technical writer:
1. Align Yourself with Your client. As a technical writer, you are putting together a written extension of the company you are representing. As such, your writing style and treatment will have to exude the same values and philosophies as your client’s.
I have to emphasize this since a lot of writers tend to inject a personal, sometimes even cliched style to their work, rather than preserving their company’s voice and tone. Knowing what your client represents will form the basis of your mindset when working on whatever deliverables expected of you.
2. Begin with the End in Mind. What exactly do you want your document to accomplish? What exactly do you want your target audience to do upon reading your work?
This determines which are the more important parts of your writing- which ones will help achieve your mission, and which ones are just plain unnecessary. Helps you make good use of your time, allowing you to focus your energies on what’s most important.
3. Stick to the Basics of the Writing Process. Many writers take this for granted, but there’s a reason that this simple system has been in place for years. If you’re writing for a living, this should really be second nature, as it helps organize your efforts and maximize your effectiveness.
- determine your purpose and your audience,
- collect information,
- organize and outline the information,
- write your first draft,
- and finally, revise and edit your work.
Create the Best Possible Experience for your Audience
4. Make Yourself Understandable. Organize your ideas in easy-to-digest portions. Stick to the most important ideas, and get straight to the point. Other related, “nice-to-know” ideas may be incorporated later on, but outside your main article.
Simple things can help you achieve this: use shorter paragraphs, stick to a smaller word count as much as possible, use easy-to-understand words whenever you can.
5. Make Extra Detail Available. Some of your readers may get it right away, and then there are those who might just need a little extra help grasping the concept, and then there are those who just want to get down and dirty.
Provide for extra- but still optional- information. Your main text must be able to stand up on its own, but you must also facilitate understanding by means of illustrations, flowcharts, process flows, even videos or added text and breakaway columns if you have to.
6. Make Your Content Engaging. Technical writing doesn’t have to be such a chore. Straight to the point, yes. But never boring.
This is where your creativity comes in. Your goal is to make your content as relevant to your audience as possible. As long as they can continually relate with your work, you have been able to meet their needs.
7. Understand Your Target Audience. Write and revise your content according to how your target audience thinks and understands things. Getting into their heads- knowing how their minds process information, how they might react, what they feel is important- allows you to customize your content to tailor-fit their needs.
This goes hand-in-hand with #6. And I have to say, this is one of the more important things you have to remember. I’ve seen some good concepts fall flat because the target audience don’t appreciate the presentation or the way it’s written.
Understand Your Role as a Writer in the Grand Scheme of Things.
8. You’re Not Expected to Know Everything. Nobody does, right? In fact, chances are, your client will probably be handing you stuff to fix and re-write. The raw stuff usually comes from some subject matter expert (SME), who usually isn’t too keen on doing the writing himself. Which is where you come in.
The best way to go about your job is to constantly interact with the SME. Whenever you need to clarify facts and figures, the SME should always be the first person you consult with. His job is to provide you with all the information you need. Your job is to organize it, keep it straight-to-the-point, and make it relevant to your target audience.
9. You are Ultimately a Part of a Team. You might be doing all the writing, but you also have to understand that you’ll also be dealing with graphics people, editors, photographers, and now even multimedia artists and new media specialists.
Your team’s goal is to create deliverables using various media- whether on print, using audio & video, and even the internet. Synergize with them, work as harmoniously as possible, and be a good team player.
10. Open Yourself to Feedback. Make yourself available to your target audience. Did your work have its intended effect? Were there parts that needed more explaining? Did they like the way the ideas were presented? Was your client ultimately satisfied with your work output?
Just as important as delivering good writing, is getting real honest feedback. Getting objective feedback is your way of learning. It allows you to hone your writing skills some more by focusing on what made you connect well with your target audience, and by improving on your shortcomings.
So there you have it ladies and gentlemen. I hope this post helps.