Technical Descriptions
Before you begin to write a technical description, consider carefully how the audience and the purpose of the document will affect what you write. Your sense of your audience will determine not only how technical your vocabulary should be but also how long your sentences and paragraphs should be.
Another audience-related factor is your use of graphics. Less knowledgeable readers may need simple graphics; they might have trouble understanding complicated schematics or charts. As you consider your audience, think about whether any of your readers are from other cultures and might therefore expect different topics, organization, or writing style in the description.
Consider your purpose: What are you trying to accomplish with this description? If you want your readers to understand how a personal computer works, write a general description that applies to several brands and sizes of computers. If you want your readers to understand how a specific computer works, write a description specific to that computer. Your purpose will determine every aspect of the description, including its length, the amount of detail, and the number and type of graphics.
DRAFTING EFFECTIVE DESCRIPTIONS
There is no single organization or format used for descriptions. Because descriptions are written for different audiences and different purposes, they can take many shapes and forms. However, the following four suggestions will guide you in most situations:
- Indicate clearly the nature and scope of the description
- Introduce the description clearly
- Provide appropriate detail
- End the description with a brief conclusion
INDICATE CLEARLY THE NATURE AND SCOPE OF THE DESCRIPTION
If the description is to be a separate document, give it a title. If the description is to be part of a longer document, give it a section heading. In either case, clearly state the subject and indicate whether the description is general or particular. For instance, a general description of an object might be titled “Description of a Minivan,” and a particular description, “Description of the 2015 Honda Odyssey.” A general description of a process might be called “Description of the Process of Designing a New Production Car,” and a particular description, “Description of the Process of Designing the Chevrolet Malibu.”
INTRODUCE THE DESCRIPTION CLEARLY
Start with a general overview: you want to give readers a broad understanding of the object, mechanism, or process. Consider adding a graphic that introduces the overall concept. For example, in describing a process, you might include a flowchart summarizing the steps in the body of the description; in describing an object, such as a bicycle, you might include a photograph or a drawing showing the major components you will describe in detail in the body.
PROVIDE APPROPRIATE DETAIL
In the body of the description, treat each major part or step as a separate item. In describing an object or a mechanism, define each part and then, if