Single sourcing : building modular documentation / Kurt Ament.

Format:

Book

Author/Creator:

Ament, Kurt, 1960-

Language:

English

Subjects (All):

Technical writing.

Physical Description:

1 online resource (247 p.)

Edition:

1st ed.

Place of Publication:

Norwich, NY : William Andrew Pub., c2003.

Language Note:

English

Summary:

Single sourcing is more than mechanical document conversion. It is an information development strategy. Although it is often confused with the process of converting paper-based documents into online formats, single sourcing is a writing strategy that enables technical writers to develop centralized information modules, then map them to distinct audiences and media. For technical writers, single sourcing means modular writing and information mapping. Rather than developing information for a given format, such as a user guide or online help, technical writers develop information modules at t

Contents:

Front Cover; Single Sourcing: Building Modular Documentation; Copyright Page; Contents; Foreword; Preface; Chapter 1. About single sourcing; In this chapter; What is single sourcing?; Reasons for single sourcing; How single sourcing works; Types of single sourcing; Successful single sourcing; Chapter 2. Building documents; In this chapter; Step 1 Identifying modules; Step 2 Labeling modules; Step 3 Organizing modules; Step 4 Building modules; Step 5 Editing modules; Step 6 Organizing documents; Step 7 Cross-referencing documents; Step 8 Converting documents; Step 9 Testing documents

Step 10 Developing guidelinesChapter 3. Structuring content; In this chapter; Captions; Cross-references; Definition lists; Examples; Figures; Front matter; Glossaries; Headings; Indexes; Itemized lists; Notes; Organization; Procedures; Processes; Section contents; Tables; Tables of contents; Topics; Troubleshooting scenarios; Chapter 4. Configuring language; In this chapter; Abbreviations; Capitalization; Parallel construction; Person; Punctuation; Sentence construction; Tense; Voice; Chapter 5. Leveraging technology; In this chapter; Conditional text; Conventions; Development tools

FilenamesLocalization; Search engines; Variables; Glossary; Index

Notes:

Includes index.

ISBN:

1-282-02747-6

9786612027475

0-08-094703-4

0-8155-1902-8

OCLC:

437108122