Share this Page URL

Chapter 5. Clarity > Define each term that is new to the intended audience - Pg. 144

Easy to understand Define each term that is new to the intended audience In all writing, the transactions between the writer and the user of the infor- mation depend on the vocabulary that they have in common. When users first encounter a new subject, it might seem like a foreign language, with its own vocabulary and rules for combining the concepts that the terms express. For example, native speakers of English who have never developed a computer application might feel as lost as if they were in a foreign country the first time that they try to use an application development tool. Some terms might be familiar, but their definitions might differ from what users expect. Object and class, for example, are familiar words, but they have special meanings in object-oriented programming. Define terms that are new to users or are used differently from what users expect. Such terms include acronyms and other abbreviations. In the text where you first use a new term, explain the term in a meaningful way and highlight it. Try not to use the term before that. To help users recognize the terms and definitions that you use, highlight