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.
Subject:Have QA compile the help project? From:Lynda Straus <Lynda_Straus -at- THEMONEYSTORE -dot- COM> Date:Tue, 11 Nov 1997 12:12:35 -0800
My development team uses PVCS for storage/tracking of the source files
for a Paradox-based application. I create and maintain the online help
for this application on my hard drive, with backups to a network drive.
Background - sorta long, sorry:
We now have mostly a new development staff, with resulting confusion
(the old process was never documented) about the process of compiling
and delivering individual application files to QA, then deploying to
Production, using several directories out on multiple network servers.
Development has decided to have QA check out the files from PVCS,
compile, then do acceptance testing on the newly-compiled files/whole
application. Deployment to Production is then from the approved QA
subdirectories instead of the development subdirectories, which are
generally only unit-tested and may not be the latest version of a form
or file.
My question:
Development suggested having QA do my compiling over the network. I
said that it couldn't work, first, because there are problems when
compiling over a network (they asked, what?, and I didn't know, I just
heard it here on the listserv) and second, because of all the project
settings, troubleshooting, etc., involved. They weren't impressed.
I need reasons why the help author *only* should be doing the work up to
the point of delivery. OR, if anyone is handing over a ready-to-compile
folder (mine's 480 files, 10MG before compiling, and one file, 780KB
after compiling) to the QA staff, please let me know, and how well does
it work?
Thanks much,
Lynda Straus
lynda_straus -at- themoneystore -dot- com