Minimalism as a framework

IEEE Transactions on Professional Communication

Volumn 40, Issue 4, 1997, Pages 265-274

  Oatey, Michael ^a   Cawood, Malcolm ^b  

^a LONDON SOUTH BANK UNIVERSITY   (United Kingdom)

^b Select Software Tools plc   (United Kingdom)

Author keywords

Documentation; Manuals; Minimalism

Indexed keywords

COMPUTER SYSTEM RECOVERY; COMPUTER SYSTEMS PROGRAMMING; ERROR ANALYSIS;

MINIMALISM;

SYSTEM PROGRAM DOCUMENTATION;

EID: 0031358203     PISSN: 03611434     EISSN: None     Source Type: Journal    
DOI: 10.1109/47.650004     Document Type: Article

References (34)

1. J. M. Carroll and H. van der Meij, "Ten misconceptions about minimalism," IEEE Trans. Prof. Commun., vol. 39, no. 2, pp. 72-86, 1996.
2. R. J. Brockmann, Writing Better Computer Documentation: From Paper to Hypertext, version 2. New York: Wiley, 1990.
3. R. L. Glass, "Through a glass darkly," Data Base for Adv. Inform. Syst., vol. 27, no. 1, pp. 14-16, 1996.
4. J. M. Carroll, The Nurnberg Funnel: Designing Minimalist Instruction for Practical Computer Skill. Cambridge, MA: MIT Press, 1990.
5. J. Scholtz and M. Hanson, "Usability testing a minimal manual for the Intel SatisFAXtion faxmodem," IEEE Trans. Prof. Commun., vol. 36, no. 1, pp. 7-11, 1993.
6. J. S. Craig, "Using a structured design analysis to simplify complex inhouse computer manuals," IEEE Trans. Prof. Commun., vol. 35, no. 1, pp. 7-12, 1992.
7. J. E. Ramsey and K. Oatley, "Designing minimal computer manuals from scratch," Instruct. Sci., vol. 21, pp. 85-99, 1992.
8. M Oatey, "Minimalism and quick reference documentation," in Colloquium on Issues in Computer Support for Documentation and Manuals. London, U.K.: Inst. Elec. Eng., Dig. no. 1993/169, 1993, pp. 2/1-2/3.
9. W. Horton, Designing and Writing Online Documentation: Hypermedia for Self-Supporttng Products, 2nd ed. New York: Wiley, 1994.
10. _, "Dump the dumb screen dumps," Tech. Commun., vol. 40, no. 1, pp. 146-148, 1993.
11. J. Price and H. Korman, How to Communicate Technical Communication: A Handbook of Software and Hardware Documentation. Redwood City, CA: Benjamin/Cummings, 1993.
12. E. H. Weiss, How to Write Usable Documentation, 2nd ed. Phoenix, AZ: Oryx, 1991.
13. D. Ince, "At last, a few words of advice," The Independent, Oct. 14, 1991, p. 18.
14. C. Hallgren, "The Nurnberg Funnel: A minimal collection," J. Comput. Document., vol. 16, no. 1, pp. 11-17, 1992.
15. M. B. Coney and C. S. Chatfield, "Rethinking the author-reader relationship in computer documentation," J. Comput. Document, vol. 20, no. 2, pp. 23-29, 1996.
16. D. K. Farkas, "The role of balloon help," J. Comput. Document., vol. 17, no. 2, pp. 3-19, 1993.
17. D. Charney, L. Reder, and G. Wells, "Studies of elaboration in instructional texts," in Effective Documentation: What we Have Learned from Research, S. Doheny-Farina, Ed. Cambridge, MA: MIT Press, 1988, pp. 47-72.
18. R. G. Waite, "Organizing computer manuals on the basis of user tasks," in Proc. 31st Int. Technical Communication Conf., Soc. Tech. Comm., 1984, pp. WE 38-40.
19. P. Reitman, "Streamlining your documentation using quick references," IEEE Trans. Prof. Commun., vol. 31, no. 2, pp. 75-83, 1988.
20. C. E. Beck, "Systems theory and rhetoric: A theoretical model of communication," Tech. Commun., vol. 42, no. 1, pp. 133-141, 1995.
21. P. Brooksbank, "Rhetorical considerations for the humanization of online help," in Proc. IEEE Int. Professional Communication Conf. (Banff, Alta., Canada, Sept. 28-Oct. 1, 1994), pp. 361-365.
22. M. J. Killingsworth, "Toward a rhetoric of technological action," in Proc. 37th Int. Technical Communication Conf., Soc. Tech. Comm, 1990, pp. CC 17-19.
23. S. P. Sanders, "Building better bridges: Persuasive structure in technical writing," in Proc. 37th Int. Technical Communication Conf., Soc. Tech. Comm., 1990, pp. CC 23-25.
24. K. Burke, A Rhetoric of Motives. Berkeley, CA: Univ. Calif. Press, 1950.
25. M. Oatey, "Trial and error versus instructions," Communicator, vol. 4, no. 7, pp. 7-8, 1994.
26. R. E. Horn, "Commentary on the Nurnberg funnel," J. Comput. Document., vol. 16, no. 1, pp. 3-11, 1992.
27. T. R. Williams and D. K. Farkas, "Minimalism reconsidered: Should we design documentation for exploratory learning?" SIGCHI Bull., vol. 24, no. 2, pp. 41-50, 1992.
28. G. Vanderlinden, T. G. Cocklin, and M. McKita, "Testing and developing minimalist tutorials: A case study," in Proc. 35th Int. Tecnical. Communication Conf., Soc. Tech. Commun., 1988, pp. RET 196-199.
29. D. K. Farkas and T. R. Williams, "John Carroll's The Nurnberg Funnel and minimalist documentation," IEEE Trans. Prof. Commun., vol. 33, no. 4, pp. 182-187, 1990.
30. B. Mirel, S. Feinberg, and L. Allmendinger, "Designing manuals for active learning styles," Tech. Commun., vol. 37, no. 1, pp. 75-87, 1991.
31. G. Mitchell, "Shrink-wrapping the formula for better information: End user vs MIS computer documentation preferences," in Proc. IEEE Int. Professional Communication Conf. (Banff, Alta., Canada, Sept. 28-Oct. 1, 1994), pp. 361-365.
32. S. W. Draper and K. Oatley, "Action centred manuals or minimalist instruction? Alternative theories for Carroll's minimal manuals," in Computer and Writing: State of the Art, P. Holt and N Williams, Eds. Oxford, U.K.: Intellect Books, 1990, pp. 222-243.
33. B. Shneidermann, Designing the User Interface: Strategies for Effective Human-Computer Interaction, 2nd ed. Reading, MA: Addison-Wesley, 1992.
34. D. K. Farkas, "Encyclopaedic reference as a model for print documentation," Tech. Commun., vol. 36, no. 2, pp. 122-125, 1990.