Home Library Translate
A A A
Share »
Follow us on Facebook Follow us on Twitter Follow us on LinkedIn
Connect »

Blog: Business Communications

Menu

  • This Blog's Home
  • Guest Writer Submissions
  • Policies
  • To Subscribe to a Blog
  • About
  • Feedback

Defining a Technical Writer

By Theresa Pojuner on June 28, 2011

In today’s world, a Technical Writer wears many hats and possesses many traits. A Technical Writer will wear hats as an Interviewer, Researcher, Analyst, Editor, and Tester, just to mention a few. The one trait they all have in common is that they must be extremely detailed. The Technical Writer has to be a detail-oriented individual with the ability to communicate to their audience via text and images. The Technical Writer has to have a sense of curiosity in order to understand and write about the framework of a product or technical information. Whether it’s as simple as writing about how and when to press a key or as complex as describing the steps involved in building a new application from inception to completion, the writer will need to be able to communicate every detail effectively.

Some other qualities that a Technical Writer has are:

Interviewing Skills:

The Technical Writer needs to be able to interview subject matter experts, project managers, co-workers, users, and clients in order to gather any relevant information needed to complete a set of documentation. They will use their interpersonal skills to understand the target audience and to find out what they need in order to complete the documentation. They will also use these skills to work with subject matter experts to gather information such as the background of a project, the steps for running routine processes or finding out what changes to the product were needed, made, and why.

Research Skills:

The Technical Writer may need to perform research for various types of tools needed to complete a document. They may need to research for an appropriate storyboard or animation tool to use along with the document to add visual clarity. If the document contains a lot of data, a suitable data diagramming tool may be needed where you can define elements and their attributes, or a querying tool to present relevant data effectively.

Analyst Skills:

The Technical Writer may need to gather and analyze data to produce certain types of requested reports, or to create data files and be able to report on them to management. By knowing how the data was gathered and the mechanisms used to derive the results, the writer could then translate the information, and be able to format and present it in simpler terms. For example, if a computer hardware problem affected data results, the writer would work with those involved to summarize the incident, define the causes, and recommend solutions for presentations to other teams or for future referral.

Testing Skills:

The Technical Writer may need to perform tests to ensure that everything documented was accurate and valid. For example, if Test Plans for the Quality Assurance group were needed to be written, the Technical Writer must write clearly and concisely about reviewed processes, procedures, hardware, and/or software applications as a part of the test plan. To further the example, if an application field that accepts data needs to be tested, the test plan would need to contain every possible scenario imaginable to test out that particular field.

Information Sensitivity Skills:

The Technical Writer has to have an eye for detail and be able to write what the reader needs to know, especially when it comes to confidential information. They have to be able to distinguish what is important to document and what is not. This can be determined by reviewing the requirements of an end user‘s purpose of the document. For example, an IT Systems requirement document could be used by a business sponsor to justify the project expenditure and an IT project manager would use it to make sure all of the high level requirements are a part of the project plan.

So, how do you know if you have the aptitude or talent to be a Technical Writer? If you are a good listener, enjoy learning and enjoy sharing information with others, then you can be a Technical Writer. What distinguishes some writers as Technical writers is that they write about technical subjects within different industries and have the industry knowledge to do so. They could be working within a software, manufacturing, financial, automobile, pharmaceutical, or publishing company and must have familiarity with the industry terminology.

But what types of documents does a Technical Writer create? That question will be answered in the next post. I hope you will enjoy these posts on technical writing as much as I enjoy writing them. If you have any questions or would like more detail on certain topics, please leave a comment.

« Previous Next »

Search Our Site

Meet This Blog’s Host

Gail Zack Anderson, President of Applause, Inc., has nearly 20 years experience in training and coaching. She provides individual presentation coaching, and leads effective presentation workshops and effective trainer workshops. [Read more ...]


Theresa Pojuner is a Documentation Specialist with over 20 years of writing experience and is skilled in many areas of documentation, for example, Style Guides, Training Manuals and Test Cases, wth a specialty n Technical Writing and Procedures. [Read more ...]

Recent Blog Posts
Alternate Recent Posts Widget

  • Becoming A Technical Writer-Communicator Review
  • Creating A Knowledge Community
  • Tips for Handling Technical Writer Stress
  • Likeminded Communication
  • A Technical Writer Is Different From Other Writers
  • Involve and Engage Your Audience 20 Ways
  • Tips On Documenting Processes
  • Communicating Technical Writing Review
  • Communicating Via Visual Designs
  • Special Tips for Laptop Presentations

Related Library Topics

  • Body Language
  • Netiquette

Categories of Posts

  • Basics and Overviews
  • Body Language
  • Communicating Change
  • Communication Best Practices
  • Feedback (Sharing)
  • Humor in speaking
  • images
  • Listening
  • Netiquette
  • Presenting
  • slide shows
  • Speaking Skills
  • Team Presentations
  • technical writing
  • Telephone Skills
  • Uncategorized
  • Visual Aids
  • Voice and Vocal Habits
  • Writing

Library's Blogs

  • Boards of Directors
  • Building a Business
  • Business Communications
  • Business Ethics, Culture and Performance
  • Business Planning
  • Career Management
  • Coaching and Action Learning
  • Consulting and Organizational Development
  • Crisis Management
  • Customer Service
  • Facilitation
  • Free Management Library Blogs
  • Fundraising for Nonprofits
  • Human Resources
  • Leadership
  • Marketing and Social Media
  • Nonprofit Capacity Building
  • Project Management
  • Quality Management
  • Social Enterprise
  • Spirituality
  • Strategic Planning
  • Supervision
  • Team Building and Performance
  • Training and Development
About Feedback Legal Privacy Policy Contact Us
Free Management Library, © Copyright Authenticity Consulting, LLC ®; All rights reserved.
  • Graphics by Wylde Hare LLC
  • Website maintained by Caitlin Cahill

By continuing to use this site, you agree to our Privacy Policy.X