Vocabulary and Diction in the Classroom
EXAMPLE ONE:
Most defects are bad but some are worse than others. Software developers have to know how to identify the defects that will cause the biggest problems and correct these first. This is not rocket science—people just have to discipline themselves to look for errors as they occur. Technical managers also have to know how to keep track of the defects (through some of the ways we discussed in class). They also have to know how to make decisions based on their findings and tracings.
EXAMPLE TWO:
Not all defects in software products are created equal, and not all have the same effects on the shipment decisions that a technical manager must make. When a project manager or software development team tracks the severity levels of problems in the code, shipment decisions become easier. Severity levels can be established as part of the plan for testing the product, which generally includes function testing as well as integrated system testing. Severity levels may be set, for example, on a scale of 1 to 4, where Sev1 errors cause the program to abort, Sev2 errors impede user progress, Sev3 errors cause a particular function not to work, and Sev4 errors represent cosmetic changes that will make the software better but will not have any of the effects of the other three severity types. Using the severity system of classification and an automated tracking system, technical managers have the data they need to make important decisions about whether to ship a product. For example, a product with three Sev4 errors remaining in it will probably be shipped, whereas one with four Sev1 errors will not.
Note that even though the first writer understands some basic principles from the technical management course, Example 1 lacks the vocabulary to express knowledge from the course. The writer compensates by using vague terms to establish criteria, such as bad and worse, and falls back on clichés, such as rocket science.
The second writer has mastered the special words needed to express the concepts taught in the course and to draw conclusions from what the professor has taught. The writing in Example 2 is clear, focused, and avoids clichés. The style and tone are also appropriate.