BN.com Gift Guide

Single Sourcing: Building Modular Documentation / Edition 1

Paperback (Print)
Used and New from Other Sellers
Used and New from Other Sellers
from $9.97
Usually ships in 1-2 business days
(Save 82%)
Other sellers (Paperback)
  • All (7) from $9.97   
  • New (2) from $42.79   
  • Used (5) from $9.97   

Overview

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 the element (section, paragraph, and sentence) level. They then map these information modules to preselected audiences and media.

This guide explains in plain language and by example how to develop single source documents. It shows technical writers how to develop standalone information modules, then map these modules to a variety of audiences and formats using proven information mapping techniques. In essence, the guide provides a flexible framework for modular technical writing that can be applied to any audience in any medium.

Read More Show Less

Editorial Reviews

From the Publisher
"The book is an easy read and is chock full of tips and guidelines." -Ann Rockley
EStreams
Every now and then, you come across a book that makes you stop and think. This is one such book. The timing of the release of Single Sourcing could not be better, for it draws together many of the ideas being presented today at online content development, web publishing and online learning conferences. There is a consensus building that early online web-based learning systems generally failed to satisfy their objectives due to bad information design and a lack of adherence to accepted pedagogical principles. This book masterfully addresses the information design part of the problem. Although aimed at technical documentation writers, editors, professors and students, the methodology is being adopted by non-technical educators involved in developing online learning content. "Single sourcing is a method for developing re-usable information." The methodology delivers "modular content that works anywhere, anytime, anyhow." Information that by design can be both migrated to other communication mediums and cognitively repurposed to address specific audiences or learning objectives. The book presents an overview of the single source technical documentation development method used by large defense, software and multimedia companies.

The book is a well-executed example of modular documentation. Even before reading the content of the book, the efficiency of single sourcing is evident by just browsing through the pages. Concepts being presented are easily identified, defined and connected to related concepts. Each chapter in the book begins with an introduction followed by an annotated table of contents for the chapter. The ten steps of the single source methodology to building documents are laid out in the second chapter of the book. The third chapter, the largest of the book, covers layout guidelines for structuring content. Lastly, writing guidelines are presented in chapter four. Rules for using abbreviations, sentence construction, punctuation, and other "language configurations" are covered. The last chapter of the book, "leveraging technology" is the weakest part of the work. The chapter almost seems like an afterthought as it lacks the depth of treatment the other areas of the book receive. The chapter presents technology considerations requiring attention in writing guidelines for content development. Overall, the book is strongly recommended for professionals involved in developing online information and corporate and academic library collections supporting technical communication and e-learning development activities.
James A. Buczynski

Read More Show Less

Product Details

  • ISBN-13: 9780815514916
  • Publisher: Elsevier Science
  • Publication date: 12/17/2007
  • Edition description: First Edition
  • Edition number: 1
  • Pages: 245
  • Product dimensions: 6.98 (w) x 9.00 (h) x 0.65 (d)

Table of Contents

About Single Sourcing
Building Documents
Structuring Content
Troubleshooting Scenarios
Configuring Language
Abbreviations
Capitalization
Parallel Construction
Person Punctuation
Sentence Construction
Tense Voice
Leveraging Technology
Conditional Text
Conventions
Development Tools
Filenames
Localization
Search Engines
Variables
Glossary
Index

Read More Show Less

Customer Reviews

Be the first to write a review
( 0 )
Rating Distribution

5 Star

(0)

4 Star

(0)

3 Star

(0)

2 Star

(0)

1 Star

(0)

Your Rating:

Your Name: Create a Pen Name or

Barnes & Noble.com Review Rules

Our reader reviews allow you to share your comments on titles you liked, or didn't, with others. By submitting an online review, you are representing to Barnes & Noble.com that all information contained in your review is original and accurate in all respects, and that the submission of such content by you and the posting of such content by Barnes & Noble.com does not and will not violate the rights of any third party. Please follow the rules below to help ensure that your review can be posted.

Reviews by Our Customers Under the Age of 13

We highly value and respect everyone's opinion concerning the titles we offer. However, we cannot allow persons under the age of 13 to have accounts at BN.com or to post customer reviews. Please see our Terms of Use for more details.

What to exclude from your review:

Please do not write about reviews, commentary, or information posted on the product page. If you see any errors in the information on the product page, please send us an email.

Reviews should not contain any of the following:

  • - HTML tags, profanity, obscenities, vulgarities, or comments that defame anyone
  • - Time-sensitive information such as tour dates, signings, lectures, etc.
  • - Single-word reviews. Other people will read your review to discover why you liked or didn't like the title. Be descriptive.
  • - Comments focusing on the author or that may ruin the ending for others
  • - Phone numbers, addresses, URLs
  • - Pricing and availability information or alternative ordering information
  • - Advertisements or commercial solicitation

Reminder:

  • - By submitting a review, you grant to Barnes & Noble.com and its sublicensees the royalty-free, perpetual, irrevocable right and license to use the review in accordance with the Barnes & Noble.com Terms of Use.
  • - Barnes & Noble.com reserves the right not to post any review -- particularly those that do not follow the terms and conditions of these Rules. Barnes & Noble.com also reserves the right to remove any review at any time without notice.
  • - See Terms of Use for other conditions and disclaimers.
Search for Products You'd Like to Recommend

Recommend other products that relate to your review. Just search for them below and share!

Create a Pen Name

Your Pen Name is your unique identity on BN.com. It will appear on the reviews you write and other website activities. Your Pen Name cannot be edited, changed or deleted once submitted.

 
Your Pen Name can be any combination of alphanumeric characters (plus - and _), and must be at least two characters long.

Continue Anonymously
Sort by: Showing all of 2 Customer Reviews
  • Anonymous

    Posted June 13, 2003

    Single Sourcing

    The concept of modular content is central to single sourcing, but until now there was very little information available on how to actually design and create effective modular documentation. Now Kurt Ament has created the book that helps you do just that. Single Sourcing: Building Modular Documentation' provides a clear and concise introduction to building modular documentation. The book is divided into five parts. Chapter 1 'About single sourcing' introduces the concepts of single sourcing including the reasons, benefits, types, and what makes single sourcing successful. Chapter 2 'Building documents' gets right into the heart of the subject by providing a 10 step process for building modular documentation including how to identify, label, organize, build, and edit modules then build documents from your modules. He also emphasizes the importance of developing guidelines for authors to follow. Chapter 3 'Structuring content' provides guidelines on creating structured content. Guidelines are provided for such common content types as procedures, glossaries, examples, indexes, notes, troubleshooting scenarios, and many more Chapter 4, 'Configuring Language' emphasizes that good modular content is more than just 'chunks' of information; it is well written content. This chapter provides guidelines for developing consistent standards for writing content such as abbreviations, capitalization, punctuation, tense, and voice. Chapter 5, 'Leveraging technology' provides an introduction to how you can use technology to support your single sourcing effort. What I like best about 'Single Sourcing: Building Modular Documentation' is that Ament practices what he preaches; the content is highly modular, consistently structured, and full of examples. He provides examples of common content and how the content could be changed to reflect the concepts he presents. The book is an easy read and is chock full of tips and guidelines. 'Single Sourcing: Building Modular Documentation' provides an excellent resource for creators of single source technical documentation.

    Was this review helpful? Yes  No   Report this review
  • Anonymous

    Posted June 13, 2003

    Single Sourcing

    Kurt Ament has hit the nail on the head! His latest effort, 'Single Sourcing: Building Modular Documentation' is a valuable reference for those of us who seek to save time, effort, and money by implementing a productive method of creating information once and reusing it often. Ament covers the issues -- step by step -- that many others only discuss. He lays out a simple roadmap, complete with real world examples that have worked -- or not worked -- for his clients. In Chapter 1 (About Single Sourcing), he carefully defines 'single sourcing' and explains related concepts (reusable content, modular writing, and assembled documents) in ways that are easy to understand and free of techno-jargon. And, he does us all a big favor by addressing the negatives associated with using technology to assemble documents by explaining that it actually takes more creativity to write content that can fit into multiple media, for multiple audiences, than it does to continually rewrite information over and over again each time it is needed. Chapter 2 (Building Documents) and Chapter 3 (Structuring Content) are of particular value to those seeking to understand the shift in thinking required to master single sourcing. Writers, programmers and managers will all benefit from these chapters. Each chapter is packed full of tips and examples you can begin using today! Chapter 4 (Configuring Language) explains how to 'configure' your writing to support and increase usability while Chapter 5 (Leveraging Technology) touches on issues including conditional text, conventions, localization, translation, variables and more. As are the previous chapters, Chapter 5 is written in clear, concise language and is not a chapter business types should skip. In fact, it's just the opposite. Managers and decision makers need to understand the concepts explained in this chapter because many of the benefits a single source strategy can deliver are made possible by combining good planning with the right technology. And, while this chapter is certainly not about selecting software tools, the author helps his readers understand some of the issues they will need to understand as they begin thinking about their strategy and the types of functionality they'll need to support with the tools they select. What I like most about 'Single Sourcing' is that Ament went straight for the meat of the issues. He doesn't belabor points or confuse the reader by jumping back and forth from subject to subject (as so many poorly written IT-related books do). Instead, he supplies us with a book you can read in an afternoon and use the information contained within the next day at work. But, be forewarned. You're going to want your sticky notes and your highlighting markers nearby. Chances are you'll be using them a lot!

    Was this review helpful? Yes  No   Report this review
Sort by: Showing all of 2 Customer Reviews

If you find inappropriate content, please report it to Barnes & Noble
Why is this product inappropriate?
Comments (optional)