Reuse of text/modular information

Subject: Reuse of text/modular information
From: geoff-h -at- MTL -dot- FERIC -dot- CA
Date: Fri, 18 Jul 1997 12:47:19 -0500

Reusing text ("modular information") is a great
productivity booster for creating the _first draft_ of a
manual or online help system, but that's all it ever is.
First, context always changes somewhat, and you have to
analyze the final text for each delivery medium to
determine how well it's really going to work. Second, it's
ridiculously easy to screw up something created using
modular information through basic human carelessness. One
great example: The manual for a GM station wagon I once
owned frequently referred to an entirely different class of
car... an obvious case of using database publishing and
forgetting to proofread the final manual.

--Geoff Hart @8^{)} geoff-h -at- mtl -dot- feric -dot- ca
Disclaimer: Speaking for myself, not FERIC.

TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html


Previous by Author: Flatter learning curves
Next by Author: Word -> AS/400
Previous by Thread: Flatter learning curves
Next by Thread: Re: Reuse of text/modular information


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


Sponsored Ads