Browse Prior Art Database

Multi-Environment Preprocessor for Documentation Publishing System

IP.com Disclosure Number: IPCOM000112120D
Original Publication Date: 1994-Apr-01
Included in the Prior Art Database: 2005-Mar-26
Document File: 4 page(s) / 105K

Publishing Venue

IBM

Related People

Amundsen, LC: AUTHOR [+2]

Abstract

The technique described in this disclosure eliminates the need to create and maintain duplicate source material when producing documentation using more than one type of publishing software, thus reducing documentation costs by up to a factor of 2 or more.

This text was extracted from an ASCII text file.
This is the abbreviated version, containing approximately 52% of the total text.

Multi-Environment Preprocessor for Documentation Publishing System

      The technique described in this disclosure eliminates the need
to create and maintain duplicate source material when producing
documentation using more than one type of publishing software, thus
reducing documentation costs by up to a factor of 2 or more.

      A MULTI-ENVIRONMENT PREPROCESSOR FOR DOCUMENTATION PUBLISHING
SYSTEMS - Today's requirement of having software and hardware
documentation available in many formats has led to increased
challenges for Information Developers.  Documentation for products
running on multiple platforms, and documentation delivered in both
traditional hardcopy and the newer "online" form, often requires
multiple versions of the same source material.  This is because
different publishing systems for different platforms often require
drastically different source preparation and format.  This
"duplicate" source is more costly to develop and maintain than if
"common" source were used.

      This disclosure describes the technique of "preprocessing"
source material before using publishing software to build the final
documentation.  Using this technique can result in dramatic savings
in information development costs, and can improve quality in the
documentation because duplicate source maintenance is not required.

      TRADITIONAL INFORMATION DEVELOPMENT FOR MULTIPLE PUBLISHING
SYSTEMS - When documentation is required in multiple forms, such as
hardcopy and online, different publishing software must often be
used.  The traditional method of information development under this
situation is shown in Fig. 1.

      Early in the documentation process, the original source
material diverges to accommodate the different requirements for each
publishing system used.  Often individual writers are assigned for
each publishing system, and these writers have the burden of ensuring
that the duplicate source does not diverge in technical content.
Quality problems often occur when material is not updated
consistently.

      AN...