Becoming a Technical Writer

MSTP-Cover I have received quite a few emails asking me about becoming a Technical Writer. I appreciate these emails and do what I can to steer people in the right direction.

After a couple of emails asking similar questions, it seemed prudent to create a post dedicated to this issue. Here is the advice I have for you concerning becoming a technical writer:

What is a Technical Writer?

The most important thing about being a technical writer is being able to convey, in simple terms to a wide audience, how a product works and how it is used. You can have the best product in the world but if your audience is unable to figure out the features and functionality then the product might be perceived as crap.
The main skill of a technical writer is the ability to speak with developers and subject matter experts and then translate this information into useful units of information for your audience – whoever that audience may be: developers, network administrators, end users. Your job is to document concepts, how the product works and how to use it.

Technical Writing Cycle

To create good usable content, you need to follow a creation cycle. Here is an example of a production cycle:

  • Read specs or initial product information – create rough drafts and schedules for content
  • Get an idea of features and functionality by using the product, and talking to Developers and Subject Matter Experts
  • Write initial content to be sent out for review
  • Cycle of Review / Revise – repeat until content is ready
  • Content delivery and possible localization into other languages, if appropriate

Becoming a Technical Writer

I have a couple of posts that to review as technical writing samples:

These posts will give you some examples of technical writing. I have others if you want to dig through my blog a bit. If you are really interested in becoming a technical writer, you should start building up a portfolio on your blog, or on your computer. Pick some ‘how to’s’ you want to write about, and then document them. If you get the chance have your friends review this content to ensure that you have written the information that people need to get the task done. This will start giving you some experience and will give you samples to hand over to potential employers when the time is right.

Check if your local college offers any technical writing classes. Check out the Microsoft Manual of Style for Technical Publications – you can purchase a used version on Amazon.com. The style guide will give you a foundation for technical writing, such as how to write about the interface, and what the different interface components are called. I will admit the style guide is Windows biased, but it will still give you a solid foundation about technical writing. I am sure there are other excellent style guides out there, but this is the one I am most familiar with.
Technical writers can earn a decent living, and doesn’t necessarily mean you will earn less then developers. Remember you are the voice of the product, and without a good voice a product will not do well. Good technology companies recognize this fact.

Microsoft.com/college is a site that contains great information about the requirements for becoming a technical writer at Microsoft as well as information concerning other careers. It is an excellent resource for understanding the different careers available at Microsoft.

7 Responses to “Becoming a Technical Writer”

  1. teeni Says:

    This is a great post and another way you show how personable a technical site can be. It’s wonderful that you are willing to try and point people in the right direction when they are looking to follow a similar career path as you have chosen. Hmmm – where were you when I was becoming a technical writer? LOL 🙂

  2. Exit 78 » Be careful and don’t post your draft… unless you mean to! Says:

    […] the blogger blogged about it. Thomas Willingham, a technical writer at Microsoft, was working on Becoming a Technical Writer when he hit publish instead of one of the drop down menus. He wrote about the error in Feed […]

  3. Thomas Says:

    teeni – Thanks, I have received questions about what I do and how I do it. I am always willing to take time to speak with others about technical careers and the associated career paths.
    That is one of the reason that I periodically give career talks at the local colleges.

  4. lydia Says:

    i would like to become a technical writter and i would like to be helped with aguideline

  5. seo yarışması Says:

    ur drupal theme for wordpress is really good 😀

  6. mad tech Says:

    lydia,

    Before you do anything, go back to school and learn capitalization and spelling!!! Cheeez…

  7. Technical Blogger Says:

    Good post! Very helpful, I’m glad you decided to post about becoming a technical writer. I’m pretty interested!


Leave a comment