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:Re: Framemaker help From:Peter Gold <pgold -at- NETCOM -dot- COM> Date:Mon, 3 Nov 1997 16:43:16 -0800
I'm posting this to the list as requested by Julie Mills; it's a
follow-up to an original post by Hilary Jones that Julie received from a
co-worker.
----- forwarded -----
On Mon, 3 Nov 1997 millsja -at- OHMEDA -dot- BOC -dot- COM wrote:
> Please pass this on to Hillary Jones,
>
> I setup a program at my company to compile help and quick reference guides
> out of Framemaker. The same principle saves big bucks on translations.
>
> The important thing to remember is that FRAMEMAKER is only a tool.
>
> A human must come up with a document outline
> includes the necessary text in reasonable chunks.
>
> Writers must use a common glossary or every chunk will use different words
> for the same thing - driving the end user nuts.
>
> If you plan to reuse text between products, use good programming practices
> (e.g. global variables). We use <MAX_FLOW> not 15 l/min in archived text.
>
> You need a library of chunks writers can brouse through. PDF is a good
format
> to use.
>
> Chunks need to be large enough to satand on their own through the review
> phase or you can chop documents into chunks after review.
>
> Add these items of info to the chunk database (approval date/change log).
>
> Associate translated chunks with their English base (a BIG COST saver).
>
> Regards, julie mills (home e-mail is windmark -at- execpc -dot- com)
>