Advice for Single-Sourcing

I have seen the future and it works. We have just finished our first single-sourcing project using mif2go to convert FrameMaker source files to HTML Help *.chm files. These files are also the source of our printed user guide AND a hyperlinked PDF of the user guide placed on the distribution CD. There was considerable once-off pain setting up conversion templates (including CSS files) and conversion options but our next project will be much faster. The converted files DO NOT require ANY hand tweaking -- we just hand over to the release people to put the *.chm file on the installer CD. Our testing and support people are rapt, and consider the new help far better than the old help. An outsider would have no inkling that the help was produced in this way.

Finger, Hedley. InFrame (2002). Articles>Content Management>Single Sourcing

A Case Study in Modular Documentation  

Modular documentation is a variation on single-sourcing methodology developed by Interim Technology Consulting in response to a client’s needs. Our client needed documentation on multiple formats that could be easily modified for multiple customers of their customized software package. The process of developing the modular methodology required considerations such as how to define, structure, and access the information modules in a way that worked for the current project and also provided a foundation for future projects. Interim Technology also wanted a methodology we could use for other clients.

Johnson, Melanie M. STC Proceedings (2000). Articles>Content Management>Single Sourcing

Cherryleaf Survey: Use of Single-Sourcing Solutions

During March and April 2003, Cherryleaf carried out an online survey into the current trends in technical communication. One of the questions we asked was: Do the people directly involved with user assistance development at your organization use a single sourcing authoring solution? Our findings are summarised in the article

Cherryleaf (2003). Articles>Content Management>Single Sourcing>Reports

Choosing the Right CMS Authoring Tools

There is no single best authoring environment provided by a content management system. Instead, the authoring tools must be matched to the job at hand to ensure they are easy and efficient to use.

Robertson, James. Step Two (2003). Articles>Content Management>Single Sourcing

Collaborating with Tools for Single-Sourcing  

A discussion of single-sourcing using FrameMaker and WebWorks Publisher.

Bhatia, Neeraj and Frederick Menezes. STC India (2001). Articles>Content Management>Single Sourcing>Adobe FrameMaker

Communicate Editorial Changes

Streamline your review process with the robust collaboration tool set in Adobe® InCopy™ 2.0. With InCopy, you can track changed text, and add notes and comments without disturbing line breaks. Later, others on the team can easily identify who.

Adobe (2003). Articles>Content Management>Single Sourcing>Adobe GoLive

Content vs. Product: The Effects of Single Sourcing on the Teaching of Technical Communication    

Identifies and discusses the effects of single sourcing on the writing process. Provides suggestions for incorporating the teaching of single sourcing into technical communication courses

Eble, Michelle F. Technical Communication Online (2003). Articles>Content Management>Single Sourcing>Rhetoric

Converting from Paper to Online  

This demonstration describes the process and pitfalls encountered during the conversion of paper documents to online, CD-ROM documents that occurred at Cisco Systems, Inc.

Altemus, Desiree L. STC Proceedings (1994). Articles>Content Management>Single Sourcing

Creating Single-Sourced Information Products  

Until recently, single sourcing has been limited to the process of putting identical information into multiple information products. However, the results of a singlesourced approach need not be identical. You can customize the outputs to contain only the information that is appropriate for the specific situation. This presentation provides a high-level overview to the advantages of single sourcing and how to implement and maintain such a solution.

Stevens, Dawn M. STC Proceedings (1999). Articles>Content Management>Single Sourcing

Curing Publishing Woes with a Content Management System  

Mescan's article helps technical communication managers determine which content management solutions are best for their particular goals and problems.

Mescan, Suzanne. Intercom (2004). Articles>Content Management>Single Sourcing

Customizing the Appearance of Your Manual, Help System, and HTML Help System  

Doc-To-Help gives Help authors complete control over the look, feel, and content of a project's printed manual, Windows Help system, HTML files, and HTML Help system. Maintaining different content is controlled using Doc-To-Help's conditional text feature, which allows authors to mark content for print-only, online-only, WinHelp-only, and so on. In this article we discuss how you control the appearance of the printed manuals and Help using Word templates, and HTML output using cascading style.

ComponentOne (1999). Articles>Content Management>Single Sourcing>Documentation

Definition of Information Management Terms

There is considerable confusion in the marketplace regarding the definition of various information management terms. The scope and role of specific information systems is particularly blurry, in part caused by the lack of consensus between vendors. With the aim of lessening this confusion, this briefing provides an at-a-glance definition of terms for a range of information systems.

Robertson, James. Step Two. Articles>Content Management>Single Sourcing>Glossary

Developing a Content-Management Strategy: Implications in a Multi-Language Environment  

Why we went to a single-source CMS and how we went about it.

Douma, Barbara. ComTech Services (2001). Articles>Content Management>Single Sourcing>Case Studies

Developing a Database Publishing System: A Demonstration  

We developed a database publishing system that uses raw data from a database and produces camera ready copy using Microsoft Access, FrameMaker, and Brio Publish. This type of project requires a project plan that defines the scope of the project, a complete understanding of the various relationships in the database, selection of the right tools for the task, and a sensitivity to the needs of the users who face dramatic change in their environment. This demonstration focuses on all aspects of this effort.

Cantoni, Georgina C. and Judith L. 'Judy' Glick-Smith. STC Proceedings (1995). Articles>Content Management>Single Sourcing>Microsoft Access

Developing and Maintaining a Large Document for Publication in Multiple Media  

This paper outlines the development of the Software Technology Reference Guide—a 500-page directory of software technologies— from the planning phase to its publication in both hard copy and HTML. It explores the problems of coordinating multiple, remotely located authors; producing frequent drafts when material is changing rapidly; managing a large documentation project; maintaining a source document for publication in multiple media; and handling the conversion of a complex hard-copy document to a usable online document.

Brune, Kimberly. STC Proceedings (1998). Articles>Content Management>Single Sourcing

Developing Information for Multiple Formats: You Can Get There from Here  

This paper describes the experiences of SAS Institute Inc. in developing single-source software documentation for presentation in multiple formats. The project is an ongoing team effort from all areas of the Publications Division. Our main goal is to develop online and hardcopy reference documentation. Toward this end, we set goals of using single-source files, reusing information, and tracking all information chunks and the relationships among them. To accomplish these goals we had to make decisions about the tools we are going to use, what information we are going to include, how we will design and present the modular information, linking and indexing strategies, and testing. This paper discusses the choices we made in light of our goals.

Moell, Patricia G. and Helen F. Weeks. STC Proceedings (1996). Articles>Content Management>Single Sourcing

Device Indepenence: Single Sourcing's Other Side  

Considers the possible ramifications for technical communicators of device-independent publishing.

Perlin, Neil E. Intercom (2005). Articles>Content Management>Single Sourcing

Distributed Workgroups Employing Single-Sourcing Techniques Around the Globe  

Single sourcing, which is increasingly used at the technical writer's workplace, has now reached the classroom of Technical Communication programs. This paper examines the impact of working on an XML-based single-sourcing solution on a geographically diverse graduate student team whose partners were all singlesourcing novices. It shows that managing communication within the virtual team is superordinate to managing the publication process. The paper discusses best-practice strategies for transient start-up publication teams, which rely solely on online communication, pointing to the differences between teams in the classroom and in business organizations.

Kaempf, Charlotte. STC Proceedings (2003). Articles>Content Management>Single Sourcing

Dynamic Content Management  

Introduces dynamic content, a method of single sourcing that 'meets individual users' needs by assembling a series of information objects in response to the userís requests or requirements.' She walks readers through a mock project involving the creation and delivery of dynamic content.

Rockley, Ann. Intercom (2001). Articles>Content Management>Single Sourcing

Echoes from the Past: DITA, Help, Single-Sourcing Tools — Looking from the 60s to Today

The historian of technical communications, R. John Brockmann, researched efforts to document products going back centuries. He finds that some of today’s hottest new documentation ideas were present in the work of those creating, documenting, and selling the technology of manufacturing just after the revolutionary war.

Ng, Daniel. I'd Rather Be Writing (2008). Articles>Content Management>Single Sourcing>History

Eliminating the END GAME from Electronic Deliverables

While executive management may sometimes believe that anyone can write and that a technical writer's job is to "Just Publish It", it may be time for technical writers to look at what they can do to improve the "end game" process, which Porter describes as "All the steps needed to create the desired output format – HTML, PDF, online help system, etc. – from the source content." By taking a closer look at the publishing process, without regard to content, technical communicators may discover ways they can streamline the steps it takes to get content published and ready for the end consumer.

Porter, Alan J. Writing Assistance (2005). Articles>Content Management>Single Sourcing>Online

Enterprise Content Management: A Critical Review  

A presentation about the use of ECM within the CMSwatch website.

Byrne, Tony. IAsummit (2004). Articles>Content Management>Single Sourcing

Enterprise Profiling  

Documents play a vital role in Enterprise Content Management. Unlike other content sources, 'document' creation and capture can occur at every desktop, in every process, and by every on-line application.

Strong, Karen V. KMworld (2001). Articles>Content Management>Single Sourcing

Fight the Unbeatable Foe: Challenges in Implementing Single Sourcing  

Single sourcing documentation is a hot topic among technical writers these days, but very few organizations have implemented single sourcing strategies or solutions. This session presents the problems faced by organizations that want to move towards single sourcing and steps to successfully implement a single sourcing strategy and solution in your organization.

Sukach, Rebecca, Robert Kennedy and Marie Devine. STC Proceedings (2003). Articles>Content Management>Single Sourcing

Fundamental Concepts of Reuse  

Content reuse is fundamental to a successful unified content strategy.This chapter defines content reuse and the benefits ofits use.It explores how other industries have employed reuse for decades to improve their processes and the quality oftheir products. Content can be reused in many ways. The choice ofthe different methods and options for reuse are dependent upon your organization’s needs and technology.This chapter details the pros and cons ofusing each method and the associated options,and it provides the concepts that underlie the remainder ofthe book.

Rockley, Ann. AIfIA (2003). Articles>Content Management>Single Sourcing>Content Strategy