RE: Modular documentation questions

Subject: RE: Modular documentation questions
From: "tom -dot- green -at- iwon -dot- com" <tom -dot- green -at- iwon -dot- com>
To: ejray -at- raycomm -dot- com, techwr-l -at- lists -dot- raycomm -dot- com
Date: Wed, 10 Sep 2003 10:37:03 -0400 (EDT)


Interesting. You may have hit on something Eric in trying to define modular documentation. I hope I'm not coming totally from some other planet here but here is MY impression of modular documentation.

I was first introduced to what was called modular documentation when I did InfoMapping in my first writing gig. That worked on the concept of writing in "chunks" of information. Now, I am also doing what they call modular documentation in XML. I write (until Monday) in Arbortext Epic Editor and use SigmaLink as the Electronic Document Management System (EDMS). All the topics and subtopics are broken up into "chunks" of information and written into Document Type Definitions (DTDs). The finished products, or chapters and topics are now in modules and containers. They are then linked together into a manual and previewed into a PDF document and sent out to the field electronically. These "chunks" or modules can be reused and linked to other manuals. Does this help or is everyone just confused on a higher level now?



Tom Green



_______________________________________________





Previous by Author: RE: Prolegomenon vs. Preface
Next by Author: Re: OT (sorry Eric): viral explosion?
Previous by Thread: RE: Modular documentation questions
Next by Thread: RE: Modular documentation questions


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


Sponsored Ads