C.E. Beck
2 articles-
Abstract
To discover the similarities and differences between primary and secondary computer manuals, and to account for the popularity of the secondary texts, two best-selling books for word processing and spreadsheet programs are compared to documentation supplied by the manufacturer. A heuristic for analyzing software documentation based on cognitive and rhetorical principles is developed and applied to the corporate documentation for (WordPerfect 5.0) in contrast to Stewart's Using WordPerfect 5 from Que, and the corporate documentation from 'Lotus 1-2-3' in contrast to Gilbert and Williams's 'The ABC's of 1-2-3 from Sybex.' It is shown that the trade texts from Que and Sybex contain more conceptual background information than the corporate documentation and differ in their rhetorical stance: the writers provide a richer context by giving more examples for applying the software; the writers provide global and structural frameworks; the writers use persuasive marketing techniques to ease the reader's anxieties and remind them of the software's benefits; and the writers identify themselves.< <ETX xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:xlink="http://www.w3.org/1999/xlink">></ETX>
-
Abstract
Analyzing proposals for evidence of enthusiasm verified a method of lexical analysis and substantiated the presence of enthusiasm in social science/humanities proposals but not in science/engineering proposals. Proposal evaluators, both experts and nonexperts, react to technical accuracy as well as subjective elements in the proposal document itself. A study of word usage identified a lexicon that reflected enthusiasm in proposals, then analyzed 1000-word samples of text for the presence of this vocabulary. Testing this method on government requests for proposals (RFPs) and business salesmanship texts determined a range of values for an enthusiasm index (EI). Subsequent analysis of fifteen technical proposals as a group revealed no significant difference between the RFPs and the proposals themselves. However, a breakdown by subject yielded a significant difference between those from social science/humanities and those from science/engineering. The successful proposals contained occurrences of enthusiastic lexicon, but the method only examined this one indicator of enthusiasm.< <ETX xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:xlink="http://www.w3.org/1999/xlink">></ETX>