Search results

Learn some tools (TW Job)

Series: How to get a job in technical writing

by Tom Johnson on Dec 20, 2009
categories: beginners

Tools are a major part of a technical writer's world. You're in charge of designing, laying out, and publishing all your content. Most employers want to you to know certain core tools, or at least to be tool savvy enough to learn their tools. Here are the four types of tools I recommend that you learn.

Learn a help authoring tool, such as Madcap Flare, Adobe RoboHelp, or Author-it. When you document a complex software application, you usually need a powerful help authoring tool to create an online help file. Alternatively, use a text editor such as oXygen and learn DITA.

Second, learn a page layout tool, such as Adobe InDesign, Microsoft Word, or Adobe Framemaker. I use page layout tools when I'm creating quick reference guides. Depending on your technical writing role, you may be creating pamphlets, brochures, newsletters, or short guides with a lot of design elements. The page layout tools give you a lot of control over the display, position, and layout of your text and images. (Okay, maybe not Microsoft Word, but you can do some page layout with it.)

Third, learn a graphics tool, such as SnagIt, Photoshop, or Illustrator. You'll need a graphics tool to capture and modify screenshots, add arrows, or create diagrams showing concepts. SnagIt is the easiest to learn and will probably work for most situations. Try to learn SnagIt's quick styles.

Finally, learn a video capture tool, such as Camtasia Studio or Adobe Captivate. Although video tutorials aren't always common help deliverables, when you add this to your mix, you significantly expand what you can offer. Video tutorials are also how a large number of people learn software.

Technical writing positions aren't always the same. You may be in a company that uses DITA, or one that has a content management system in which you author content, or a company that has some other method for authoring (perhaps they use Visio heavily). Even if you don't know the exact tools the employer wants, if you have technical aptitude with a variety of tools, such as the ones I listed above, that aptitude may be enough to convince the employer you're qualified.

To learn tools, go at a slow pace. Try learning them an hour a day over the course of several months. You don't need to master the tools; just be somewhat familiar with them and be able to produce something using them.

Some students have asked whether they should substitute open source tools for the commercial tools (for example, Gimp instead of Photoshop) because open source tools are the only ones they can afford. I do not recommend this substitution. First of all, it takes a huge investment of time to learn some tools. Second, some employers are so bent on you knowing a particular tool, it's not worth the risk to put so much effort into a tool they probably don't use.

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.

If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.