Top 10 Most Frequently Asked Questions about Technical Writing

Charting your course in technical communication

Charting your course in technical communication

Through my blog, I receive a lot of questions from users. I’ve seen the same questions numerous times, so I’ve decided to compile a list of answers to those questions and add a link to them on my contact page. These are the 10 most frequently asked questions about technical writing:

1. What technical writing tools should I learn?

In general, learn markup and style languages more than a specific tool, since languages have a more widespread application than specific tools. The most useful markup and style languages are HTML, XML, and CSS. You can find resources to learn these languages online.

For specific tools, look at http://indeed.com for technical writer jobs in your area. After analyzing the job postings, try to identify a common trend in the tools required. Learn those tools. You can also review commonly used tools from previous WritersUA tool surveys.

In general, learn these four types of tools:

  • Help authoring tools (such as Madcap Flare, Confluence, Robohelp, Doc-to-Help, or some other)
  • Graphics tools (Snagit, Capture, Photoshop, Illustrator)
  • Video recording tools (Camtasia Studio, Screenflow, Captivate)
  • Page layout tool (InDesign, Word, Framemaker)

Even if you don’t know the exact tool the job requires, your proficiency with some of the above tools will give you credibility that you can learn the company’s specific toolset.

2. Should I get a technical writing degree or certificate?

If you’re in a position in life where education fits easily into your schedule, go for it. For example, if you have the time, money, and are interested in a degree, take advantage of the opportunity. Once you settle down in life with kids, a job, and other commitments, it can be really hard to get that masters degree in tech comm.

However, a technical communication degree or certificate isn’t necessary to get a job in technical writing. If you’re not in a life situation where education fits easily into your schedule and pocketbook, don’t worry about it. Few professional technical writers have degrees or certificates specifically in technical communication anyway.

Instead, focus your efforts in developing a strong portfolio with examples that demonstrate your knowledge and skills. (By the way, even if you do pursue higher education in technical communication, you will still need a portfolio to get a job.)

3. How do I get a job in technical writing without experience?

If you don’t have any experience, volunteer your technical writing skills with an open source application, such as WordPress. For example, you could rewrite or add information in the WordPress Codex. Alternatively, you could create instructions for a product you use, such as your phone or camera.

The exact product doesn’t so matter much. Interviewers will be interested to see your writing style, your ability to articulate complex concepts, your mastery of advanced tools to author the information, your sense of organization and detail, and more.

4. I’m interested in technical writing, but isn’t it boring?

No, technical writing isn’t boring. It actually taps into quite a few creative skills, but that creativity isn’t creativity so much in writing. It’s more like creativity in problem solving, layout and design, finding ways to illustrate concepts, and in thinking through ways that people might use the product.

In addition to using these creative skills, you’ll be immersed in an environment full of interaction designers, engineers, quality assurance testers, project managers, analysts, corporate communications teams, and more. In short, IT departments can be energetic, cool places to work.

At the very least, give technical writing a try. If you find it boring, switch to something else.

5. Would I be good technical writer? I don’t have a background in technology or writing.

Most tech writers don’t have a specific background in technical writing. You will be a good tech writer if you have any of the following qualities:

  • You’re a good problem solver.
  • You’re patient (e.g., when you run into technical problems, you don’t throw your mouse across the room).
  • You’re tech savvy.
  • You’re a gadget person.
  • You like interviewing and talking with people.
  • You like writing and language.
  • You like figuring out how things work.
  • You like layout, design, and visuals.

6. I don’t have money to buy the tools, but all technical writer jobs seem to require knowledge of these tools.

You could purchase academic versions of the software for usually half price or less. For example, you can buy an academic license to Madcap Flare for $500. Most Adobe products have similar academic discounts.

If you consider the cost of software to be equivalent to buying books for class and paying tuition, the cost is more understandable. (Note that academic software restricts you from using the software commercially.)

You could also download trial versions of the software. The trials usually end after 30 days, so you have a limited opportunity to learn the software during this time. You could reformat your computer every 30 days and install new trial versions, but doing so would skirt around the idea of a trial, in addition to being a major pain.

You could try using open source substitutes, but I don’t recommend this method, because usually employers look for knowledge of specific tools, usually industry standard ones. When you invest so much time and energy in learning a software tool, you want this time investment to have a significant return.

Employers want prospective employees to know industry standard tools such as Photoshop rather than Gimp, Microsoft Word rather than Open Office, Camtasia Studio rather than Camstudio, and so on. However, if open source is your only option, it’s better than nothing.

7. Could I get a job as a remote tech writer working from home?

If you’re new to the field, you probably won’t find a remote technical writing contract. Usually you need more experience before employers will trust you to work from home. Even so, many employers want you to be on site at least part of the time.

8. What exactly do technical writers do?

Technical writers do a variety of tasks, including some or all of the following:

  • Explore products and analyze requirements data enough to become an expert about the product.
  • Interview and meet with subject matter experts in regular meetings and one-on-one situations to ask questions and learn more about products.
  • Create instructions on how to use software applications and hardware products.
  • Create illustrations, diagrams, and other visuals that explain technical concepts.
  • Record video tutorials that show how to use technical products.
  • Relay user feedback to product teams on how to improve the products, whether that feedback comes through usability testing, training, or other user immersion.
  • Create elearning courses and simulations for users to learn products.
  • Create technology how-to articles for marketing efforts to increase awareness and adoption of technology products.

9. I have an assignment to interview a technical writer. Can I send you my list of questions?

Sorry, but I usually don’t have the bandwidth to respond at length for this. However, you could probably find a technical communicator willing to respond if you asked around on Twitter and included the hashtag #techcomm. If someone does respond and is interested in posting their responses as a guest post on my blog, I would love to do that.

10. How can I get a job as a technical writer?

Getting your first job as a technical writer is usually the hardest. Follow these seven steps to get a job as a technical writer:

  1. Build up your knowledge of tools and languages. For example, learn CSS, HTML, and XML. Also learn a help authoring tool, a graphics tool, a video recording tool, and a page layout tool.
  2. Create a portfolio of sample technical writing deliverables. For example, create an online help, a how-to guide, a quick start guide, and a video tutorial.
  3. If necessary, move to a city that has a lot of IT opportunities. Some popular cities are Seattle, San Jose, Austin, Boston, New York City, Denver, San Antonio, Chicago, Atlanta, Baltimore, Philadelphia, Minneapolis, Las Vegas, and many more. If you search on indeed.com for technical writer jobs, you’ll see a breakdown of available jobs by city. Also, if you look at previous cities the STC Summit has been held in, it usually indicates a high number of technical writers in the area. Basically any tech hub will have a lot of tech writing opportunities.
  4. Identify your strengths and build additional specializations. These specializations might include usability, video tutorials, information architecture, marketing, e-learning, content strategy, project management, or another hybrid skill.
  5. Start a blog to record insights and experiences about the field of tech comm. A blog will provide evidence of your knowledge, show your enthusiasm for the field, and let employers get a feel for your writing style, intelligence, and engagement.
  6. Research the companies you want to work for, and identify a good fit for your skills. After you research the companies, create a custom cover letter that presents a case for why you would make such a good fit for the company. Although custom cover letters take time to create, they can be a powerful example of your writing skills. Taking the time to write a custom cover letter will certainly get the attention of a prospective employer.
  7. Apply for the jobs. There are a lot of job sites (Monster, Dice, Yahoo, and more). I like Indeed.com because it consolidates job listings from multiple sites.

Madcap Flare Adobe Robohelp

This entry was posted in beginner tips & careers, general on by .

By Tom Johnson

I'm a technical writer working for The 41st Parameter in San Jose, California. I'm primarily interested in topics related to technical writing, such as visual communication (video tutorials, illustrations), findability (organization, information architecture), API documentation (code examples, programming), and web publishing (web platforms, interactivity) -- pretty much everything related to technical writing. If you're trying to keep up to date about the field of technical communication, subscribe to my blog either by RSS or by email. To learn more about me, see my About page. You can also contact me if you have questions.

7 thoughts on “Top 10 Most Frequently Asked Questions about Technical Writing

  1. Diego Schiavon

    W3C Schools is a no-no in front-end developerland – lots of mistakes and wrong information.

    The Mozilla Foundation and others have put up a counter-information site at http://w3fools.com/. They provide a list of alternative resources to learn web programming and suggest to filter out W3Schools results from Google searches.

    For the rest, according to your answer to question #5, I REALLY should be in a different profession – but I still love what I am doing.

    1. Tom Johnson

      Diego, thanks for your comment. I didn’t know W3C Schools had so many mistakes and wrong information. I updated the post to simply recommend that people learn the tools online.

  2. Tammy Paul

    I was a little puzzled by your listing FrameMaker under help authoring tools rather than page layout tools, and not listing RoboHelp under help authoring tools at all. Those seem like rather big oversights considering the industry.

    1. Tom Johnson

      Thanks Tammy. I updated the post with your recommendation. I initially listed Frame as a HAT because a lot of people use structured Frame to feed a CMS, so it functions more as an XML editor than a HAT. But this may be confusing.

  3. John Hewitt

    I have been encouraging prospective writers to document iPhone/iPad applications. Most of them have next to no documentation and it is easy to make attractive screen-captures of. Many smaller developers would be thrilled to get a free instruction set to post on their site or even include in the application, which gives the writer an opportunity to make the docs official.

  4. Murdo Guy

    Nice article Tom! Very detailed and informative. I’m planning to do some reading on this area and I’m basically starting from scratch. I’m an engineer and a writer but they don’t go too well. i also currently maintain the Fuelfixer site and yeah I know it’s a work in progress. Thanks a bunch for the info!

  5. Avadhut

    Hi Tom,

    Thanks for writing this article. This is a complete article on Technical Writing career.

    I’m a financial trainer and have written almost 80+ articles on my blog and also running an online program on financial analysis and modeling (Video tutorials).

    I’m learning Technical Writing Tools and have used Word, Excel, PowerPoint and Camtasia Studio to create elearning programs.

    I’m planning to apply for a Technical Writer position in India. I want to showcase this experience and build a strong portfolio. What else needs to be added in my portfolio?

    Regards,
    Avadhut

Comments are closed.