Writing technical articles is a challenge. There you sit, surrounded by reams of research, notes and interviews. Where do you start?
Remember 5th grade English? You start with an outline.
Outlining has fallen on hard times lately. Mind mapping and brainstorming are much more fashionable. These techniques are great when generating ideas, but once you’ve got your ideas germinating you’ve got to outline them. Without an outline, your article will:
- Be an unstructured mess.
- Take three times as long to write.
Don’t let this happen to you – outline. If it’s been a while since 5th grade – or if your “progressive” school didn’t stoop to teach you actual English skills – let me remind you why it’s important and how to do it.
- Outlining keeps you from writing an unstructured mess. Readers, especially American readers, prefer distinct sections in their media. For example, look at American screenplays. Movies invariably have three acts, and anything that doesn’t have them is considered an art film. Effective speeches often contain three parts, and readers like three points because the structure makes easier to retain information.
- Outlining shrinks your writing time by a third to a half. How do you whittle down that pile of research notes and interviews into an article or white paper? You guess it – outline it. By assigning sections to your notes before you start writing, you’ll categorize, simplify and clarify. Not bad before you’ve even written an introduction. For example, let’s say you’re writing an article about mirroring. You can divide such an article into several different sections depending on what your client wants to get across. Here are some examples of different outlines:
- 1) Explanation of mirroring 2) Differences between local and remote mirroring, 3) Contrasting mirroring with other forms of replication, or
- 1) Define mirroring 2) List environments that require mirroring 3) Decision matrix for assigning different mirroring levels.
Once you’ve done your research it’s simple to assign pieces to different sections. Believe me, it’ll light a fire under your writing time.
Christine Taylor is president of Keyword Copywriting, which helps marketing and PR pros leverage their relationships with technology clients. E-mail her at email@example.com, call her at 760-249-6071, or check out Keyword’s Website at www.keywordcopy.com
About The Author
Christine writes technical marketing communications for data storage, networking and pharmaceutical clients, including:
- StoneFly Networks
- Maranti Networks
- Obagi Medical Products
She specializes in trade journal articles, white papers, press kits and online content. She serves as a contributing editor to Computer Technology Review and acts as editor-in-chief for Storage Inc. and Storage Management Solutions.
Before moving into technical journalism and marketing she served 20 years in the IT trenches, including systems administration at Avery Dennison's Research and Development division.
This article was posted on January 28, 2004