New Technical Writer First Things To Do On The Project

OVERVIEW
You, a non-writer, have just been assigned to write the documentation for a product your company produces or markets. You may be stressed out about the assignment. Fear not! This article will get you started on the path to writing a successful document.
QUESTIONS AND NOTES
As soon as you get assigned to the documentation project you must begin to take notes and ask questions. The major goal of this early information gathering is to gain access to the sources of information that you will need in order to write your document. Thus these early notes should be related to where you will get your information: things to read and people to contact, and a product to play with.
TIP: There is always something to do or learn on a Documentation project. Don’t stop working while you are waiting for something else to happen.
LEARN PROPER USE OF YOUR WRITING TOOLS
Do NOT get immersed in new technology. For most companies and for most documentation projects, investing the money and time to learn a Content Management System or exquisite document writing software are not worth the effort. Documentation writing is often the tail end of a project, and you will have no time to learn new technologies. Instead learn to get the best from your existing word-processing tools.
* Learn about and understand why you should use your word processor’s “styles” for formatting your document. “Styles” (or whatever your word processor calls them) are sets of characteristics such as a structure and formatting. For example, Heading (level) 1 is a style, Heading 2 is another style, and so are Title, Body Text and others. When you apply a style to a block of text, two things happen: (1) the formatting of the style gets applied to the text and (2) the word processor will be able to understand the structure of the document. The word processor’s tools will use the headings to automatically generate a table of contents.
* Learn to use your word processor’s outlining capability. The outliner automatically assigns styles to the headings in your document. Design your User Document using your word processor’s outlining capability.
* Learn how to use your word processor’s revision system. The revision system is a facility where the author writes a document and then sends it to a reviewer. The reviewer can make revisions to the document, and sends it back to the author. The author can then choose to either accept or reject each revision provided by the reviewer. You will have to be able to deal with revisions from multiple reviewers for each part of the Document.
Most word processor Users do not know how to use the revision system that their software provides. You might wish to create a document about the revision system for your reviewers. Remember to tell them what the revision system is about, as well as how to use it.
Technology comes second. Our goal will be to produce a great document, providing the:
* content (the information that your Reader needs or wants) and
* effective access to that content
(giving your reader the ability to find what is needed).
DOCUMENT ALL PEOPLE ON THE PROJECT
Pretend that it is 10 years from now. You or someone else must re-write the User Documentation for the product you are now working on. You or someone else must be able to contact those who worked on the original project or the people who replaced them. You may need to ask them questions, or at least to find the notes and other background material related to the document that they produced. You must keep a record of everyone who worked on the project (for the product itself and for the User Documentation.)
The people who are working on the project include (there may be others, include them in the list):
* Project Manager
* Those who will approve the parts of the Document, and who will approve the final Document
* Project Team
* Contacts
* Marketing
* Sources of Information
* Publisher of Document
* Editor
* Indexer
You should keep (for yourself and the entire project team) the following information. It should have an entry for every person inside and outside the organization who is affiliated with the project, and these data:
* Full Name
* Role in the Product Development
* Organization and Position in the Organization
* E-mail address
* Telephone contact (FAX number)
* Office address (if there is a company-wide directory, get the address from there, when you need it)
* Their expertise and what they did on the project
* Any other relevant information
DO IT NOW: LIST THE PLAYERS
Create this list of everyone related to the project. You can keep the list using a word processor, spreadsheet, or dedicated address-book software and in your e-mail program. Use whatever method you are used to using (a computer program is best, as it permits you to edit the list, and to share it with the other members of your project team).
Include the information I suggested above about each participant. The goal is to know who worked on the project, their role in the project, and how to contact them.
Keep the list up to date.