1995 Policies and Procedures PIC Meeting  

This session is intended for those interested in (a) policies and procedures as a subject, (b) networking with others concerned with policies and procedures, (c) learning about this PIC, (d) influencing the direction of this PIC, or (e) listening, commenting, or volunteering. The first portion of the meeting will briefly review the PIC's history, mission, membership, budget, teams, goals, and progress. The second portion will be open to discuss new business.

Urgo, Raymond E. STC Proceedings (1995). Articles>Documentation>Policies and Procedures

Asking Your Users and Doing What They Need: The Story of How Federal Express Ground Operations Revamped Its User Manuals  

Worldwide Communications & Policy is a relatively new department in Federal Express, created to manage communications and produce policy and procedure (P&P) manuals for the largest division in our global company. We asked an outside consultant, JoAnn Hackos & Associates, to evaluate the existing divisional P&P manuals and conduct an audience analysis. We emerged from the process with a plan to change the existing manuals, which tried to be all things to all people, into a collection of audience-specific, task-oriented documents.

Gill, Sadie P., JoAnn T. Hackos, Mary Hartmann, Carol Sowell, and Julian S. Winstead. STC Proceedings (1994). Articles>Documentation>Policies and Procedures

Review: Best Practices in Policies and Procedures  

Page's book makes the first attempt to open the door to examples of tables of contents of P&P from a variety of organizations. He also makes an admirable attempt to position and show the P&P analyst/writer as more than a scribe, as a leader who adds value by formulating best P&P practices in collaboration with others for their organization.

Urgo, Raymond E. Technical Communication Online (2003). Articles>Reviews>Documentation>Policies and Procedures

Developing ISO 9000 Procedures  

Documentation is the foundation upon which an ISO-compliant quality system is built. Creating this documentation isn’t, however, as easy as it seems on the surface. Understanding the concept of the Standard enables writers to understand the content requirements. The structure this documentation follows will also impact the success of your registration audit. Once the documentation has been created, the control of it becomes of paramount importance. ISO requires that you control not only the documents and data you create, but also those that you receive from outside sources. Document and data control issues are one of the most common causes of registration failure!

Robinson, Ralph E. STC Proceedings (1996). Articles>Documentation>Policies and Procedures

Documenting Procedures After the Sole Subject Expert Has Left the Organization  

A corporation's or nonprofit's life without written procedures is fraught with dangers and pitfalls that can strike without warning and potentially wreak havoc on the organization's ability to function efficiently—or even to function at all—especially when the lone source of how-to information leaves the organization. The task of creating those procedures from scratch from what often amounts to skeleton information and secondhand sources can be tedious and frustrating but well worth the effort if it helps prevent the organization from being caught off guard in the future. When it comes to workplace procedures, it pays to be prepared.

Kessler, Audrey Cielinski. STC Proceedings (1999). Articles>Documentation>Policies and Procedures

Eleven Tips for Writing Incredibly Useful Procedures

Procedures are the meat and potatoes of technical writing. They help users get the job done. Follow these tips for writing clear and useful procedures that your users will appreciate.

HelpScribe (2008). Articles>Documentation>Policies and Procedures>Technical Writing

Improving Medical Treatment Procedures  

Technical writers should be alert for opportunities to improve documentation in one technical field by using appropriate techniques from other fields. In this paper, the author presents ways of improving medical treatment procedures by using elements from engineering procedures, including introductions, safety sections, warnings, conditional (branching) statements, and notes.

Gibbs, Judith M. STC Proceedings (1996). Articles>Documentation>Biomedical>Policies and Procedures

Information Gathering for Policies and Procedures  

Information gathering can be one of the most timeconsuming and potentially frustrating experiences when writing policies and procedures. Policy and procedure writers sometimes start from scratch and must investigate and research policies and procedures before the first word is ever written. Although there are many obstacles to obtaining accurate and timely information, there are also many avenues the policy and procedure writer can take to gather, utilize, and maintain information.

Dodwell, Christine. STC Proceedings (1996). Articles>Interviewing>Documentation>Policies and Procedures

Managing a Company-Wide Policies and Procedures Project  

It takes skills in three different areas to manage a company-wide policy and procedures project. First, people must be organized and motivated to participate. Executive support is critical here. And the persons actually performing the tasks must be the ones to document it. Second, the project must be clearly defined and tracked. The document creation and review process must be structured simply, to take full advantage of the documentation team’s limited time. Finally, the information published must be accurate and controlled. Work processes should be analyzed before the procedures are documented, and published procedures must be distributed to specified manual holders.

Creps, William B. STC Proceedings (1996). Articles>Project Management>Documentation>Policies and Procedures

New Guidelines for Documentation of Plants  

The DIN committee NA 152-06-01-05 UA, formerly called the NATG-F 1.5, has published a guideline for compiling information from component manuals, in its technical report 146. This report is a supplement to DIN EN 62079 and is meant to ensure that the requirements from the Machine Guidelines 98/37/EG Appendix I Ch. 1.7.4 are practically feasible. Plans are afoot to introduce the technical report at the international level (CEN).

Galbierz, Martin. tekom (2006). Articles>Documentation>Policies and Procedures

The New tekom Guideline for Safety Instructions in Operating Manuals

The EU directive 92/58/EWG of 24th June 1992 clearly defines the notification on occupational Safety and Health Safeguards. In Germany, this has been enforced through the regulations for trade associations BGV A 8 (formerly VBG 125) which regulate indication of occupational safety and health safeguards through prohibition signs, warnings, instructions or signs for action, rescue, fire protection and so on. At present there is no European standard that discusses the topic of 'Drafting Safety Instructions in Operating Manuals' adequately and in detail. Nonetheless, there are several sources but often containing only imprecise or too generalized requirements. Moreover, many judicial verdicts in various individual cases point to the manner of formulations in Safety Instructions.

Gabriel, Carl-Heinz. tekom (2004). Articles>Documentation>Policies and Procedures

Online Documentation and Local Area Networks  

The world of policies and procedures has grown with technology. The trend is now to move documentation from paper to electronic media. Most companies are taking advantage of this technology andpublishing their policies and procedures on their own intranet or Local Area Network. There are things to consider before choosing a product and making this drastic change. These are: Product Functionality, ReadabilityNiewability, File Portability, and Cost. Each company’s documentation requirements and busmess strategies will ultimately determine which online documentation product to choose.

Anderson, Michelle E. STC Proceedings (1997). Articles>Documentation>Policies and Procedures

Policies and Procedures Can Help Your Organization

Compliance and meeting operational needs are two very important reasons for implementing a system of policies and procedures.

Bizmanualz (2007). Articles>Business Communication>Documentation>Policies and Procedures

Policy and Procedure Communication and the Lone Writer  

As a lone writer developing policy and procedure documentation, many of us face what appear to be insurmountable hurdles in reaching our intended goal – useable documentation that accurately reflects the business’ operations. It usually begins with trying to get everyone to take the need for P & P documentation seriously. This can be followed by frustrations in getting the information required to write coherent and useful documentation. Then there is the need for standards for which no one sees the importance – ‘just a whim of the writer’. Add to this volatile mix the requirements of many international standards impacting how business is conducted, and you wonder why anyone in right mind would take up the challenges of this field of writing. But it really can be fun and a very rewarding field of endeavor.

Mason, Susan, Rich Maggiani, Julia Margulies and Ralph E. Robinson. STC Proceedings (2002). Articles>Documentation>Policies and Procedures>Business Communication

Procedures: The Sacred Cow Blocking the Road?  

This paper questions the dominance of procedures in paper and online computer documentation and argues that the types of behavior and conditions demanded by stepped instructions are not consistent with typical user behavior. The authors suggest that the following hierarchy of information needs more accurately describes what users want to know when they ask, “How do I:” (a) What can I do? (b) Where can I do it? (c) What are the rules or principles? (d) What are the parts and their functions of the interface that does it? and (e) What are the steps?

Hughes, Michael A. and Loren Burke. STC Proceedings (1998). Articles>Documentation>Policies and Procedures

Security Policy and Procedures Documentation

With the nation intensifying its homeland security and industry focusing on computer security, the experienced technical communicator can assist with documenting procedures.

Albing, Bill. KeyContent.org (2004). Articles>Documentation>Policies and Procedures>Technical Writing

Tackling IS0 9000 Documentation  

The IS0 9000 series of Quality Standards redefines how business will be conducted into the next century. The series is designed to measure the effectiveness of the Quality System in place, thereby ensuring both customer and company needs are always satisfied. The foundation of a robust Quality System is its documentation: problems in this area represent the largest single cause of registration failures. Quality System documentation also forms the basis upon which the 3rd party registrar builds the audit plan for your company.

Robinson, Ralph E. STC Proceedings (1997). Articles>Documentation>Standards>Policies and Procedures

TCeurope Helps to Develop European Guideline

TCeurope, the umbrella organization of European associations for technical communication, is helping with the development of a European guideline on user education for mobile terminals and e-services. The European Telecommunications Standards Institute invited TCeurope to a joint workshop in French Sophia Antipolis, where the draft was discussed intensely.

Ritter, Corinna. tekom (2006). Articles>Documentation>Policies and Procedures

Web Delivery of Corporate Policies and Procedures  

Moving policies and procedures to a corporate web site can improve an ineffective and inefficient delivery system of paper in a three-ring binder. The advantages of online delivery outweigh the disadvantages. Using a general problem solving process, the team that produced this output included customer surveys to determine that a web site was the best way to solve existing delivery problems. The team continues to evaluate the end result, attempting to improve the delivery method.

Evans, Jeanette P. STC Proceedings (2001). Articles>Documentation>Policies and Procedures