Three decades of research and professional practice on printed software tutorials for novices

Technical Communication

Volumn 56, Issue 3, 2009, Pages 265-292

  van der Meij, Hans ^a   Karreman, Joyce ^a   Steehouder, Michaël ^a  

^a UNIVERSITY OF TWENTE   (Netherlands)

Author keywords

[No Author keywords available]

Indexed keywords

EID: 70349579931     PISSN: 00493155     EISSN: None     Source Type: Journal    
DOI: None     Document Type: Article

References (115)

1. Accenture. 2008. Accenture research finds vast under-use of higher-end mobile applications among U.S. consumers. http://newsroom.accenture.com/article_display.cfm?article_id4760.
2. Astleitner, H. 2000. Designing emotionally sound instruction: The FEASP-approach. Instructional science 28: 169-198.
3. Asustek Computer Inc. 1996. Drivers installation: Creative Labs VIBRA 16C Audio, Ratingen, Germany.
4. Atkinson, R. K., S. J. Derry, A. Renkl, and D. Wortham. 2000. Learning from examples. Instructional principles form the worked examples research. Review of educational research 70: 181-214.
5. Baker, C. D., M. Emmison, and A. Firth, Eds. 2005. Calling for help. Language and social interaction in telephone helplines. Philadelphia, PA: Benjamins.
6. Bandura, A. 1977. Social learning theory. Englewood Cliffs, NJ: Prentice Hall.
7. Baycon Group. n.d. Paint Shop Pro tutorial. http://www.baycongroup.com/paint_shop_pro/p01_download.htm.
8. Bhavnani, S. K., and B. E. John. 1996. Exploring the unrealized potential of computer-aided drafting. In Proceedings of the CHI'96 conference on human factors in computing systems, ed. M.J. Tauber. New York: ACM, pp. 332-339.
9. Bhavnani, S. K., and B. E. John. 2000. The strategic use of complex computer systems. Human-computer interaction 15: 107-137.
10. Boekaerts, M. 2001. Context sensitivity. Activated motivational beliefs, current concerns and emotional arousal. In Motivation in learning contexts. Theoretical advances and methodological implications, Eds. S. Volet and S. Järvela. Amsterdam, The Netherlands: Pergamon, pp. 17-31.
11. Boeke, H. 1990. Werken met WordPerfect 5.1 voor Dos [Working with WordPerfect 5.1 for Dos]. Schoonhoven, The Netherlands: Academic Service Informatica.
12. Brave, S., C. Nass, and K. Hutchinson. 2005. Computers that care. Investigating the effects of orientation of emotion exhibited by an embodied computer agent. International journal of human-computer studies 62: 161-178.
13. Brockmann, R. J. 1998. From Millwrights to shipwrights to the twenty-first century: Explorations in a history of technical communication in the United States. Cresskill, NJ: Hampton Press.
14. Carroll, J. M. 1998. Minimalism beyond the Nurnberg funnel. Cambridge, MA: MIT Press.
15. Carroll, J. M. 1990a. An overview of minimalist instruction. Proceedings of the 23rd annual Hawaii international conference on systems sciences, January 2-5, 1990, Kailua-Kona, HI.
16. Carroll, J. M. 1990b. The Nurnberg funnel: Designing minimalist instruction for practical computer skill. Cambridge, MA: MIT Press.
17. Carroll, J. M., and R. L. Mack. 1984. Learning to use a word processor: By doing, by thinking, and by knowing. In Human factors in computing systems, eds. J. C. Thomas and M. Schneider. Norwood NJ: Intellect Books, pp. 13-51.
18. Carroll, J. M., and J. R. Olson. 1988. Mental models in human-computer interaction. In Handbook of Human-Computer Interaction, ed. M. Helander. New York, NY: Elsevier Science Inc., pp. 45-66.
19. Carroll, J. M., and M. B. Rosson. 2006. Case studies as minimalism information. IEEE transactions on professional communication 49: 1-14.
20. Carroll, J. M., P. L. Smith-Kerker, J. R. Ford, and S. A. Mazur-Rimetz. 1987. The minimal manual. Human-computer interaction 3: 123-153.
21. Choi, S., and R. E. Clark. 2006. Cognitive and affective benefits of animated pedagogical agents for learning English as a second language. Journal of educational computing research 34: 441-466.
22. Complete Training Manual. 2007. Microsoft Excel 2007 training manual. http://www.computertrainingmanual.com.
23. Coney, M. B., and C. S. Chatfield. 1996. Rethinking the author-reader relationship in computer documentation. Journal of computer documentation 20: 23-29.
24. Craig, S., B. Gholson, and D. Driscoll. 2002. Animated pedagogical agents in multimedia educational environments. Effects of agent properties, picture features, and redundancy. Journal of educational psychology 94: 428-434.
25. Doane, S. M., J. W. Pellegrino, and R. L. Klatzky. 1990. Expertise in a computer operating system: Conceptualization and performance. Human-computer interaction 5: 267-304.
26. Draper, S. W. 1985. The nature of expertise in UNIX. In Proceedings of INTERACT '84 IFIP confuence on human-computer interaction ed. B. Shackel. New York: Elsevier North-Holland, pp. 465-471.
27. Duffy, T. M., and R. Waller, Eds. 1985. Designing usable texts. Orlando, FL: Academic Press.
28. Farkas, D. K. 1999. The logical and rhetorical construction of procedural discourse. Technical communication 46: 42-54.
29. Farkas, D. K., and T. R. Williams. 1990. John Carroll's the Nurnberg funnel and minimalist documentation. IEEE transactions on professional communication 33: 182-187.
30. Field, A. 2005. Discovering statistics using SPSS, 2nd ed. London, UK: Sage. Using Framemaker (1992). San Jose, CA: Frame Technology.
31. Gellevij, M., and H. van der Meij. 2004. Empirical proof for presenting screen captures in software documentation. Technical communication 51: 224-238.
32. Gellevij, M., and H. van der Meij. 2002. Visuals in instruction. Functions of screen captures in software manuals. Ph.D. diss., University of Twente.
33. Gentner, D., and A. L. Stevens. 1983. Mental models. Hillsdale, NJ: LEA.
34. Glasbeek, H. A. 2001. Ik doe wel wat hier staat, maar hij niet. Een onderzoek naar vaardigheidsverwerving door gebruikers van leshandleidingen bij een computerprogramma [I do what it says, but it does not. A study into skills acquisition by users of computer software tutorials]. Ph.D. diss., Universiteit Utrecht.
35. Gläser-Zikuda, M., S. Fuss, M. Laukenmann, K. Metz, and C. Randler. 2005. Promoting students' emotions and achievement. Instructional design and evaluation of the ECOLE-approach. Learning and instruction 15: 481-495.
36. Gong, R., and J. Elkerton. 1990. Designing minimal documentation using a GOMS model. A usability evaluation of an engineering approach. In Proceedings of the CHI'90 conference, ed. S. Pemberton. New York: ACM, pp. 99-106.
37. Goodwin, D. 1991. Emplotting the reader. Motivation and technical documentation. Journal of technical writing and communication 21: 99-115.
38. Hackos, J. 2008. What makes minimalism so popular today? CIDM information management news, January 2008.
39. Halpern, R. 1988. Getting the most from WordPerfect 5. Berkely, CA: Osborne/McGraw-Hill.
40. Halse, R. 1986. Computer manuals for novices: the rhetorical situation. Journal of technical writing and communication 16: 105-120.
41. Hartley, J. 1978. Designing instructional text, London: Kogan Page.
42. nd ed. London: Kogan Page.
43. rd ed. London: Kogan Page.
44. Hartley, J. 2004. Designing instructional and informational text. In Handbook of research on educational communications and technology, Ed. D. H. Jonassen. Mahwah, NJ: Erlbaum, pp. 917-947.
45. Hartley, J., and P. Burnhill. 1971. Experiments with unjustified text. Visible language 5: 265-278.
46. Hartley, J., and M. Trueman. 1985. A research strategy for text designers: The role of headings. Instructional science 14: 99-155.
47. Horn, R. E. 1982. Structured writing and text design. In The technology of text: Principles for structuring, designing and displaying text, Ed. D. H. Jonassen. Mahwah, NJ: Erlbaum, pp. 341-376.
48. Horn, R. E. 1993. Structured writing at twenty-five. Performance and instruction 32: 11-17.
49. Horton, W. 1991. Illustrating computer documentation. The art of presenting information graphically on paper and online. New York: Wiley.
50. Horton, W. 1997. Secrets of user-seductive documents. Wooing and winning the reluctant reader. Arlington, VA: STC.
51. Houghton-Alicio, D. 1985. Creating computer software user guides. From manuals to menus. New York: McGraw-Hill.
52. Huing, Y. Y. C., N. T. T. Duyen, W.-C. Kong, and A.-L. Chua. 2008. Re-examining media capacity theories using workplace instant messaging. IEEE transactions on professional communication 51: 352-368.
53. International Organization for Standardization (ISO). 1998. International standard ISO 9241-11: Ergonomic requirements for office work with visual display terminals (VDTs)-part 11: Guidance on usability. Geneva, Switzerland: ISO.
54. Jansen, F., and L. Lentz. 1996. Changing standards in technical communication. Journal of technical writing and communication 26: 357-370.
55. Jennings, K. 1990. The devouring fungus. Tales of the computer age. New York: W.W. Norton.
56. Johnson-Laird, P. N. 1983. Mental models: Towards a cognitive science of language, inference and consciousness. Cambridge, UK: Cambridge University Press.
57. Jonassen, D. H. 1982. The technology of text. Principles for structuring, designing and displaying text. Englewood Cliffs, NJ: Educational Technology Publications.
58. Jonassen, D. H. 1985. The technology of text. Principles for structuring, designing and displaying text (Vol. 2). Englewood Cliffs, NJ: Educational Technology Publications.
59. Karreman, J. 2004. Use and effect of declarative information in user instructions Ph.D. diss., University of Twente.
60. Karreman, J., and M. Steehouder. 2000. Het instellen van de Vox New York. Gebruik en effect van declaratieve informatie in gebruiksaanwijzingen [Programming the Vox New York. Use and effect of declarative information in instructions for use]. In Over de grenzen van de taalbeheersing, Eds. R. Neutelings, N. Ummelen, and A. Maes. Den Haag: Sdu, the Netherlands, pp. 273-283.
61. Karreman, J., and M. Steehouder. 2002. De invloed van systeeminformatie op de transfer van procedurele kennis [The influence of system information on the transfer of procedural knowledge]. Tijdschrift voor taalbeheersing 24: 332-345.
62. Karreman, J., N. Ummelen, and M. Steehouder 2005. Procedural and declarative information: What we do and what we don't know about these information types. In Proceedings of the IEEE international professional communication conference (IPCC 2005). Limerick, Ireland: IEEE, pp. 328-333.
63. Kelby, S. 2006. The digital photography book. Berkeley, CA: Peachpit Press.
64. Keller, J. M. 1987. Development and use of ARCS mode of instructional design. Journal of instructional development 10: 2-10.
65. Kieras, D. E., and S. Bovair. 1984. The role of a mental model in learning to operate a device. Cognitive science 8: 255-273.
66. Kim, Y., and A. L. Baylor. 2006. A social-cognitive framework for pedagogical agents as learning companions. Educational technology research and development 54: 569-596.
67. Krull, R. 1998. Presentation techniques in distance education and training. In Proceedings of the IEEE international professional communication conference (IPCC 1998), vol. 2. Québec City, Canada: IEEE, pp. 93-101.
68. Krull, R. 2001. Writing for bodies in space. In Proceedings of the IEEE international professional communication conference (IPCC 1998). Santa Fe, NM: IEEE.
69. Krull, R., S. J. D'Souza., D. Roy, and D. M. Sharp. 2004. Designing procedural illustrations. IEEE transactions on professional communication 47: 27-33.
70. Krull, R., and D. M. Sharp. 2006. Visual verbs: uasing arrows to depict the direction of actions in procedural illustrations. Information design journal 14: 189-198.
71. Lazonder, A. W. 1994. Minimalist computer documentation. A study on constructive and corrective skills development. Ph.D. diss., University of Twente.
72. Lazonder, A. W., and H. van der Meij. 1993. The minimal manual. Is less really more? International journal of man machine studies 39: 729-752.
73. Lazonder, A. W., and H. van der Meij. 1994. The effect of error information in tutorial documentation. Interacting with computers 6: 23-40.
74. Lazonder, A. W., and H. van der Meij. 1995. Error information in tutorial documentation. Supporting users' errors to facilitate initial skill learning. International journal of human computer studies 42: 185-206.
75. Lester, J., S. Converse, S. Kahler, S. Barlow, B. Stone, and R. Bhoga. 1997. The Persona effect. Affective impact of animated pedagogical agents. In Proceedings of the conference of human factors in computer systems (CHI-97), ed. S. Pemberton. Atlanta, GA: ACM, pp. 359-366.
76. Loorbach, N., J. Karreman, and M. Steehouder. 2007. Adding motivational elements to an instruction manual for seniors. Effects on usability and motivation. Technical communication 54: 343-358.
77. Mayer, R. E. 2006. Multi-media learning. New York: Cambridge University Press.
78. Mayer, R. E., S. Fennel, L. Farmer, and J. Campbell. 2004. A personalization effect in multimedia learning. Students learn better when words are in conversational style rather than formal style. Journal of educational psychology 96: 389-395.
79. Moreno, R., R. E. Mayer, H. A. Spires, and J. Lester. 2001. The case for social agency in computer-based teaching. Do students learn more deeply when they interact with animated pedagogical agents? Cognition and instruction 19: 117-213.
80. Napier, H. A., R. R. Batsell, D. M. Lane, and N. S. Guadagno. 1992. Knowledge of command usage in a spreadsheet program: Impact on user interface design and training. Database 23: 13-21.
81. Endnote: the all-in-one solution (1998). No location: Niles Software, Inc.
82. Nückles, M., and A. Ertelt. 2006. The problem of describing a problem. Supporting laypersons in presenting their queries to the internet-based helpdesk. International journal of human-computer interaction 64: 648-669.
83. Oatley, K., M. C. Meldrum, and S. W. Draper. 1991. Evaluating self-instruction by minimal manual and by video for a feature of a word-processing system. Unpublished Manuscript (research report), University of Glasgow.
84. Pintrich, P. R. 2003. A motivational science perspective on the role of student motivation in learning and teaching contexts. Journal of educational psychology 95: 667-686.
85. Pollock, E., P. Chandler, and J. Sweller. 2002. Assimilating complex information. Learning and instruction 12: 61-86.
86. Price, J. 1984. How to write a computer manual. A handbook of software documentation. Menlo Park, CA: Benjamin/Cummings.
87. Price, J., and H. Korman. 1993. How to communicate technical information. A handbook of software and hardware documentation. Menlo Park, CA: Benjamin/Cummings.
88. Ramsay, J. E., and K. Oatley. 1992. Designing minimal computer manuals from scratch. Instructional science 21: 85-98.
89. Redish, J. C. 1989. Reading to learn to do. IEEE transactions on professional communication 32: 289-293.
90. Renkl, A. 1997. Learning from worked-out examples: A study on individual differences. Cognitive science 21: 1-29.
91. Schriver, K.A. 1997. Dynamics in document design. Creating texts for readers. New York: Wiley.
92. Setchi, R. M., D. T. Pham, and S. S. Dimov. 2006. A methodology for developing intelligent product manuals. Engineering applications of artificial intelligence 19: 657-669.
93. Simpson, H., and S. M. Casey. 1988. Developing effective user documentation. A human factors approach. New York: McGraw-Hill.
94. Smaldino, S. E., D. L. Lowther, and J. D. Russell. 2007. Instructional technology and media for learning. Upper Saddle River, NJ: Pearson.
95. Steehouder, M. 2002. Beyond technical communication. Users helping each other. In Proceedings of the IEEE international professional communication conference (IPCC 2002). Boston, MA: IEEE, pp. 489-499.
96. Steehouder, M. 2007. How helpdesk agents help clients. In Proceedings of the IEEE international professional communication conference (IPCC 2007). Seattle, WA: IEEE.
97. Sticht, T. 1985. Understanding readers and their uses of texts. In Designing usable texts, Eds. T. M. Duffy and R. Waller. Orlando, FL: Academic Press, pp. 315-340.
98. Sullivan, P. A., and L. Flower. 1986. How do users read computer manuals? Some protocol contributions to writer's knowledge. In Convergences. Transaction in reading and writing, Ed. B. T. Petersen. Urbana, IL: National Council of Teachers of English, pp. 163-178.
99. Sweller, J., and G. A. Cooper. 1985. The use of worked examples as a substitute for problem solving in learning algebra. Cognition and instruction 2: 59-89.
100. Ummelen, M. M. N. 1997. Procedural and declarative information in software manual: Effects on information use, task performance and knowledge. Ph.D. diss., University of Twente.
101. Van der Grijspaarde, L. 1995. Ontwerp en vergelijking van twee handleidingen bij het Acoat Recipe Core System [Design and comparison of two manuals of the Acoat Recice Core System]. M.S. thesis, University of Twente.
102. Vanderlinden, G., T. G. Cocklin, and M. McKita. 1988. Testing and developing minimalist tutorials. A case history. In Proceedings of the 35th international technical communications conference. May 10-13, 1988, Washington, DC: STC, RET-196-9.
103. Van der Meij, H. 1992. A critical assessment of the minimalist approach to documentation. In Proceedings of the 10th annual international conference on systems documentation (SIGDOC92). New York: Association for Computing Machinery, pp. 7-17.
104. Van der Meij, H. 1996. Does the manual help? An examination of the problem-solving support offered by manuals. IEEE transactions on professional communication 39: 146-156.
105. Van der Meij, H. 1997. The ISTE-approach to usability testing. IEEE transactions on professional communication 40: 209-223.
106. Van der Meij, H. 2000. The role and design of screen images in software documentation. Journal of computer assisted learning 16: 294-306.
107. Van der Meij, H. 2008. Designing for user cognition and affect in a manual. Should there be special support for the latter? Learning and instruction 18: 18-29.
108. Van der Meij, H., and J. M. Carroll. 1998. Principles and heuristics for designing minimalist instruction. In Minimalism beyond the Nurnberg funnel, Ed. J. M. Carroll. Cambridge, MA: MIT Press, pp. 19-53.
109. Van der Meij, H., and M. Gellevij. 1998. Screen captures in software documentation. Technical communication 45: 529-543.
110. Van der Meij, H., M. J. Op de Weegh, and I. H. M. Weber. In press. Heeft een (papieren) medeleerling een meerwaarde in software handleidingen? [On the added value of a pedagogical agent in software tutorials]. Pedagogische studiën.
111. Van Loggem, B. 2007. Paper-based support for computer-mediated activity: A cognitive task analysis. M.S. thesis, University of Twente.
112. Visual Steps. 2007. Internet and e-mail for seniors with Windows Vista. http://www.visualsteps.nl.
113. Wiedenbeck, S., J. A. Zavala, and J. Nawyn. 2000. An activity-based analysis of hands-on practice methods. Journal of computer assisted learning 16: 358-365.
114. Wiedenbeck, S., P. L. Zila, and D. S. McConnell. 1995. End-user training. An empirical study comparing on-line practice methods. In Proceeding of the CHI'95 Conference. New York: ACM, pp. 74-81.
115. Wright, P. 1980. Usability: the criterion for designing written information. In Processing of visible language, Ed. P. A. Kolers. New York: Plenum, pp. 183-205.