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

Trial by fire: Requirements critique

Share on Facebook :: Printer Friendly Version

—by Theresa Putkey

Published: February 2005 in Core Competencies, Viewpoints

“I thought that as a technical writer I had plenty of experience with being rejected, but the review was a trial by fire.”

In two previous articles I’ve given you a general overview of what requirements writing is, how to get involved, and how to gather requirements. But, as you know, most work isn’t done in a vacuum, so here comes the hard part — you’ve produced your requirements and now you have to get them reviewed by the customer, and maybe by developers or user interaction specialists.

In my first requirements review, I learned how to be “professional” very quickly. I thought that as a technical writer I had plenty of experience with being rejected, but the review was a trial by fire. There’s no point in beating around the bush — having requirements reviewed can be very difficult, even if you’ve gone through the process several times.

As we all know, words can be interpreted differently and a bazillion questions can come up about what you present. As the requirements writer, you have to field all these questions, even if they’re asked repeatedly (and by the same person) and you’ll have to answer them again and again, even after you’ve drawn pictures, created diagrams, done PowerPoint presentations, conducted group interviews and discovery sessions…as you see, it can be aggravating.
 
While answering all these questions, it’s helpful to remember that questions will only uncover more details, and make your requirements and the end product better. Fielding questions with grace and alacrity will (hopefully) engender respect, trust, and willingness from your co-workers to volunteer information and, yes, ask more questions.

Most of all, better communication with the customer produces requirements that suit the customers’ needs and that, after all, is the point of the requirements.

Theresa Putkey is still a contractor and a student. She can be contacted at .(JavaScript must be enabled to view this email address)

Previous: Worldly and Wise

Next: Professionalism in practicums


 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)