When moving to single-sourcing through XML and SGML, management often spends considerable time on tools evaluation and content management, but not enough on preparing the writers for the paradigm shift to the new environment. This presentation provides some hints for a successful transition for your personnel as well as your documentation.
Gelb, Janice. STC Proceedings (2003). Articles>Writing>XML>Technical Writing
Developing a Company Style Guide

Every company that produces external publications--whether brochures, research papers, or reference manuals-benefit from a company style guide. This paper discusses the advantages of a style guide, why a company-specific style guide is preferred, how to develop a style guide, and what a style guide should (and should not) include.
Gelb, Janice and Jefferey J. Gardiner. STC Proceedings (1997). Articles>Style Guides>Editing
Editing in a Single-Source Environment 
The trend in the technical documentation community is toward single-sourcing: reusing common bits of information. This paper examines the role of the editor in this process, and the effect it has on traditional editorial practices.
Gelb, Janice. STC Proceedings (2001). Presentations>Editing>Single Sourcing
Establishing an Editorial Forum 
With the advent of the World Wide Web, many areas besides Publications produce documents for outside customers. This paper discusses how to establish and organize a forum to make, track, and publicize company-wide style guidelines.
Gelb, Janice. STC Proceedings (2000). Presentations>Collaboration>Style Guides
Making Technical Reviews More Efficient 
This paper proposes the use of a database to collect and track technical review comments. It discusses the merits of using a database, provides a sample database structure, and describes use of the database in the review process.
Gelb, Janice. STC Proceedings (1999). Articles>Editing>Online
Updating a Corporate Style Guide: Process and Reality
Establish a company-wide team of writers and editors to process comments on the style guide. If applicable, aim for a geographically diverse group that represents all of your company's documentation groups.
Gelb, Janice and Alysson Troffer. STC Proceedings (2008). Presentations>Slideshows>Style Guides>Workplace
There are 14 readers currently online: 0 registered users and 14 guests. Register.

![]()
![]()


![]()
![]()
![]()