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