Current Issue

Chapter News
Features
Viewpoints
Student Views
From the Editor's Desk
Message from the President
Reviews
Society Notes & Community Announcements




 Article Archives 

Book Review
Career Development
Case Studies
Content Management
Contracting & Consulting
Core Competencies
Meeting Reviews
Usability
Networking
Online Help & Embedded Assistance
Technologies
Translation and Localization
Up and Coming Corner
Information Architecture


 Past Issues 

May, 2012
April, 2012
March, 2012
February, 2012
December, 2011
November, 2011
October, 2011
September, 2011
August, 2011
June, 2011
April, 2011
February, 2011
January, 2011
August, 2010
July, 2010
June, 2010
May, 2010
April, 2010
March, 2010
February, 2010
January, 2010
December, 2009
November, 2009
October, 2009
September, 2009
July, 2009
June, 2009
May, 2009
April, 2009
March, 2009
February, 2009
December, 2008
October, 2008
September, 2008
May, 2008
April, 2008
February, 2008
January, 2008
November, 2007
September, 2007
August, 2007
April, 2007
March, 2007
January, 2007
November, 2006
October, 2006
September, 2006
August, 2006
March, 2006
February, 2006

Another Tool in Your Tool Kit

Share on Facebook :: Printer Friendly Version

- by Theresa Putkey

Published: October 2004 in Viewpoints

As technical writers, we have the skills for requirements writing and the background of understanding the user needs.

Word is that the technical writing profession is changing—those of us who want to stay in it must expand our knowledge and skills. In the past year and a half, I have had the opportunity to work as a requirements writer. Writing requirements is an incredibly useful tool that can lead to great, and great paying, job opportunities.

Through on-the-job trial and error, I learned the ins-and-outs of requirements. Requirements writing tells a customer and programmer “what” a program should do. After analyzing the needs and tasks of the customer, a requirements writer sits down and writes out every detail, leaving no “what” decisions to the programmer. The writer does not tell the programmer “how” the requirements should be fulfilled, allowing the programmer to design the best implementation for the program.

Key skills for writing requirements are writing, and task, user, and needs analysis. Those skills sound familiar, don’t they? And don’t you wish that the programs you documented were just better in the first place? As technical writers, we have the skills for requirements writing and the background of understanding user needs. However, requirements writing requires patience and good relationship-building skills. You must build respect among your clients and coworkers for your ability to do your job, and you must be able to make decisions based on all kinds of feedback from the customer, development, and quality assurance, and then stand by those decisions in light of competing interests.

Some say that Karl Wiegers is the “requirements guru” but, as a beginner, I found his writing somewhat incomprehensible. The Software Productivity Centre does seminars, although these can be quite expensive. Look up “software requirements” on the Internet, or on amazon.ca, and go from there. See if your company needs any feature created or designed, and then ask if you can do it. If programmers are doing the designing, then they’ve got nothing to lose by letting you try it.

Theresa Putkey is currently in school at UBC, taking human geography classes. She also works part-time as a contractor. Contact her at .(JavaScript must be enabled to view this email address).

Previous: Groups Discuss the Basics

Next: Get ready: It’s a hurricane


 Subscribe via RSS

Visit the main STC website.

STC advances the theory and practice of technical communication across all user abilities and all media.


STC-related links

Note: You may need to be logged into these services to view the pages.

©2012 STC CWC | Home | .(JavaScript must be enabled to view this email address)