TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
For the first two software manuals (two manuals of a series)
that our documentation team has written and completed over
the past couple of months, we have asked the developers to
each make all of their change requests and comments in MS
Word. We then review their colored comments and make the
changes in the master documents.
Since the software team uses the GNATS problem/bug reporting
system for tracking software bugs and change requests, we
are now considering also using GNATS to track change requests
for the documentation (user manuals, reference manuals, etc)
that is evaluated during quality assurance testing cycles.
One advantage to using such a tracking system is that it
automatically keeps track of each request, and it is easy to
get info on the status of the requested changes.
Yet a very possible disadvantage in that a project coodinator
could end up spending a lot of time handling many individual
change requests (evaluating, assigning, etc) for many minor
changes (rewording of sentence, word change, spelling
change). In cases of minor changes, the time required for a
quality assurance tester to report the change (indicate a
clear change report title, write up description, indicate
place in manual, etc) could easily take 2-3 times more
effort and handling time than making the text corrections
in a Word document and a technical writer keeping track of
changes in a spreadsheet.
Can anyone share their experience in using electronic change
request systems like GNATS for documentation changes?
e-mail: jeffrey -dot- allen -at- mycom-int -dot- com
Announcing new options for IPCC 01, October 24-27 in Santa Fe,
New Mexico: attend the entire event or select a single day.
For details and online registration, visit http://ieeepcs.org/2001
Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.