Re: Automating docs compilation in the software build process

Subject: Re: Automating docs compilation in the software build process
From: "Dick Margulis " <margulis -at- mail -dot- fiam -dot- net>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 16 May 2003 12:32:16 -0400


David,

If the build is really the shipping product--and assuming I understand you correctly--then what your developers have requested is that you deliver doc source files _to the customer_, which is clearly a change in deliverables that has to be approved at your company's management level. Essentially, it's a form of giving away the cow, and your developers cannot just decide on their own that this is a good thing to do.

I think if you put it in those terms, they'll get it.

Dick

David Handy <david -dot- handy -at- automsoft -dot- com> wrote:

>Currently I provide all docs in a
>finished state, i.e. I compile the master help file from several HTML Help
>projects, build the PDFs from Framemaker, apply relevant security settings,
>and check the lot into VSS for inclusion in the build. The developers
>dislike this because the whole shooting match takes me a half-hour, whereas
>with automated scripts it could be done in moments -- they contend -- on our
>Build machine.
>
>Has anyone had any experience doing this? Are there major snags?
>


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Robohelp X3, from eHelp, lets you quickly and easily create
professional Help systems for all your Windows and Web-based
applications, including Net.

Order RoboHelp X3 in May and receive a $100 mail-in rebate, PLUS
free RoboScreenCapture and WebHelp Merge Module.

Order RoboHelp today: http://www.ehelp.com/techwr-l

---
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.



Previous by Author: RE: Somewhat OT: Tech Writers vs. other writers
Next by Author: Re: What to look for in a technical editor
Previous by Thread: Re: Automating docs compilation in the software build process
Next by Thread: Re: Automating docs compilation in the software build process


What this post helpful? Share it with friends and colleagues:


Sponsored Ads