Explanation and Assistance
It is easy to say that an explanation should be simple and that it should be written in familiar language. Advice of this sort is offered in many a technical writing handbook, often with limited elaboration. The concepts of familiarity and simplicity are not as straightforward as they appear to be, however. Users’ familiarity with particular terms can never really be predetermined because of the different ways we can “know” a word (as described in chapter 2). And what exactly is “simple” language? Hartley (1985), in his book on designing instructional text, makes several references to a writer’s conscious selection of words for a target text. Word length is mentioned (short, familiar words are easier to understand, although some long words, because of their frequent use, are quite familiar, e.g., “communication”), word type (concrete words and phrases are clearer than abstract ones), and ambiguity resulting from excessive use of abbreviations and acronyms. He also writes about the option of using readability formulas to check the suitability of a text for a given reader age group. Emden (1990) devotes a section to vocabulary choice in her handbook on writing for engineers and offers this advice: “Use words which the reader will understand”. She rightly points out the insidious danger in the use of technical language: “The reader may assume that he understands and the writer may assume that he is understood. Both may be understanding different meanings”. Sides (1984), cautioning about the use of jargon in papers and reports on computer technology, says this: “The issue of jargon is audience-dependent. Always use what the audience will understand”. This is sound advice, yet on reflection, it is so cursory that it is doubtful whether it can genuinely be fol lowed. The writer can strive to get to know the audience, and even think about providing definitions of terms, but there is still the matter of knowing how to select words or adapt one’s “jargon.” Use “fewer and simpler words,” advises Sides, referring to S. T. Coleridge as an authority on the matter.