1.

Record Nr.

UNINA9910780015103321

Autore

Ament Kurt <1960->

Titolo

Single sourcing [[electronic resource] ] : building modular documentation / / Kurt Ament

Pubbl/distr/stampa

Norwich, NY, : William Andrew Pub., c2003

ISBN

1-282-02747-6

9786612027475

0-08-094703-4

0-8155-1902-8

Descrizione fisica

1 online resource (247 p.)

Disciplina

808/.0666

Soggetti

Technical writing

Lingua di pubblicazione

Inglese

Formato

Materiale a stampa

Livello bibliografico

Monografia

Note generali

Includes index.

Nota di contenuto

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

Sommario/riassunto

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