The School for Champions is an educational website that shows you how to achieve your dreams.
![]() |
|
|
SfC Home > Technical Writing > Explanation of documentation needed by companies to improve business to succeed in technical writing. Also refer to technical communicators, writers, ISO 9000, marketing, user manuals, guides, service manuals, procedures, STC, Ron Kurtus, School for Champions. Copyright © Restrictions Types of Documentation Needed by Companiesby Ron Kurtus (revised 3 May 2003) Every business--large or small--needs documentation to operate effectively. Requirements for extensive internal documentation are spelled out in the ISO 9000 series of international standards. The major classifications of needed documents include marketing, user guides, administrative material and published works. Technical communicators are needed to write each of these types of documents. Questions you may have include:
The follow explains these types of documentation and the need for them. There is a mini-quiz near the end of the lesson. Marketing materialCompanies need written material to provide customers with information about the company and their products and/or services. The purpose is to make the public aware of what is available, as well as to help to sell the products. This material includes:
Marketing material has usually been done in slick publications, but recently promotional material and catalogs have been distributed via CD-ROM. Most companies now use their Web sites as marketing brochures. Marketing specialists and advertising copywriters have traditionally done marketing writing. Recently, professional technical documentation specialists are writing online marketing documents. User guides and manualsCompanies that make products or software need to have manuals and user guides available that will explain how to properly use the product. These documents are intended for both external customers and for use internally. Typical guides and manuals include:
Many companies are putting their guides and manuals online. Many commercial software companies have abandoned hard-copy manuals in favor of online help files packaged with the software. Quick reference guidesQuick reference guides provide ready reference to essential features during the use of hardware or software. They may include graphical devices and other job aides. Software user guidesSoftware user guides provide instructions for using a software product. Since there has been a tendency to put these manuals online, third-party publishers have been selling such books to satisfy consumer need. Software reference guidesSoftware reference guides provide accessible reference information on the features and functions of a software product. Hardware/Software combination guidesHardware/Software combination guides provide instructions for using a hardware product and modifying or programming its firmware/software. Examples include manuals for computer printers, fax machines, modems and such. Hardware user guidesHardware user guides provide instructions for using a hardware product. "Hardware" means any electronic or mechanical device, including computers, lawnmowers and stereo equipment. Hardware installation, reference and repair guidesHardware installation, reference and repair guides provide accessible reference information on the features and functions of a hardware product. They also explain how to install, modify, maintain or repair a piece of hardware. Administrative materialMost companies need documents to cover various administrative requirements. Such material includes:
The movement is to put much of this material online, on the Web, or on an internal intranet. Organization manualsOrganization manuals provide guidance to employees or customers of an organization. They include policies and procedures manuals, style and identity guides and benefits guides. Some companies are putting online versions of organization manuals on their intranet. Such documentation requires an expert in HTML. Training materialsTraining materials are publications developed for use in a training or classroom environment by either the trainer or student participant; may include manuals, tutorials, workbooks, and instructor guides. Computer-based training (CBT), Web-based training (WBT) and eLearning are cost-effective methods of training over using training manuals and trainers. Most companies tend to outsource the development of eLearning, as opposed to doing it in-house. Annual reportsAnnual reports summarize the activities or financial position of a corporation, governmental agency, or nonprofit community organization. Miscellaneous material for publicationOccasionally, companies want or need other type of writing intended for publication done for them. These include:
Magazine or trade journal articlesA company may want articles published in magazines. This material would include news and information about an organization, technology, industry, or scientific field. It may be intended for an internal or external audience, a special interest audience or the general public. NewslettersSome companies distribute newsletters giving information about company happenings. Newsletters may be intended for an internal or external audience. Technical reportsCompanies may want reports written on scientific or technical efforts. They are usually aimed at the professional community or a contracting agency. SpeechesTop company officials may need speeches written for special occasions or presentations. Some technical writers specialize in this field. SummaryThere is a wide range of documentation that companies need for effectively running their businesses. Documentation is also needed to create new business by providing information to potential customers. Besides the traditional paper-based documents, online documentation is becoming important to successful companies. Provide what others want and need ResourcesThe following resources provide information on a writing career. WebsitesSociety for Technical Communication Books
Top-rated books on Technical Writing MiscellaneousMini-quiz to check your understanding1. Why would a marketing writer need to know about online writing? 2. Why are user guides and manuals important? 3. Who should develop training materials? If you got all three correct, you are on your way to becoming a Champion in Technical Writing. If you had problems, you had better look over the material again. What do you think?Do you have any questions, comments, or opinions on this subject? If so, send an email with your feedback. We will try to get back to you as soon as possible. Share linkFeel free to establish a link from your website to pages in this site. Or use our form to send this link to yourself or a friend. Students and researchersThe Web address of this page is Please include it as a reference in your report, document, or thesis. Where can you go from here?
|
The School for Champions helps you become the type of person that can be can be called a Champion.