This article shows how user-centered design can be applied to documentation and reports the results of a two-year contextual design study. The article (1) demonstrates how contextual design can be applied to information and (2) reports some of the study's results, outlining key insights gleaned about users. The study found that users vary widely in their information needs and preferences. Users employ a variety of learning strategies in learning new software and in overcoming problems encountered within applications. Documentation can better meet variances in learning styles and user preferences when tightly integrated into applications, accessible in the user's own language. Additionally, documentation is most beneficial when several assistance options exist for users to choose among, varying according to context, task, and user need. Finally, the article discusses the constraints that affect the implementation of design ideas and explores implications for practice and additional research.
References
1.
Alpert, Bill
. “TroubleClick.”Barron's3 July 2000: 16-16.
2.
Bailey, Robert W.Human Errors in Computer Systems. Englewood Cliffs, NJ: PrenticeHall, 1983.
3.
Bates, Joseph
. “The Role of Emotion in Believable Agents.”Communications of the ACM37.7 (1994): 122-125.
4.
Beabes, Minette A.
, and Alicia Flanders. “Experiences with Using Contextual Inquiry to Design Information.”Technical Communication42 (1995): 409-420.
5.
Bernhardt, Stephen A.
, and George M. McCulley. “Knowledge Management and Pharmaceutical Development Teams: Using Writing to Guide Science.”Technical Communication47 (2000): 22-34.
6.
Beyer, Hugh
, and Karen Holtzblatt. Contextual Design Defining Customer-Centered Systems. San Francisco: Morgan Kaufmann, 1998.
7.
Bostrom, Robert P.
, Lorne Olfman, and Maung K. Sein. “The Importance of Learning Style in End-User Training.”MIS Quarterly14 (1990): 100-119.
8.
Bradford, David B.“The New Role of Technical Communication.”Technical Communication32 (1991): 13-15.
9.
Brassard, Michael
. Memory Jogger Plus. Methuen, MA: GOAL/QPC, 1989.
10.
Bresko, Laura L.“The Need for Technical Communicators on the Software Development Team.”Technical Communication38 (1991): 214-220.
11.
Carlshamre, P.
, and J. Karlsson. “A Usability-Oriented Approach to Requirements Engineering.”Proceedings of the Second International Conference on Requirements Engineering. Los Alamitos, CA: IEEE Computer Society Press, 1996. 145-145.
12.
Carroll, John M.Minimalism beyond the Nurnberg Funnel. Cambridge, MA: MIT Press, 1999.
13.
Carroll, John M.Scenario-Based Design: Envisioning Work and Technology in System Development. New York: John Wiley, 1995.
14.
Carroll, John M.
, and Judith Reitman Olson. “Mental Models in Human-Computer Interaction.”Handbook of Human-Computer Interaction. Ed. Martin Helander. New York: Elsevier Science, 1988. 45-65.
15.
Carroll, John M.
, and Mary Beth Rosson. “The Paradox of the Active User.”Interfacing Thought: Cognitive Aspects of Human-Computer Interaction. Ed. John M. Carroll. Cambridge, MA: MIT Press, 1987. 80-111.
16.
Charney, Davida H.
, Lynne M. Reder, and Gail W. Wells. “Studies of Elaboration in Instructional Texts.”Effective Documentation: What We Have Learned from Research. Ed. Stephen Doheny-Farina. Cambridge, MA: MIT Press, 1988.
17.
Clark, Margaret Sydnor
, and Susan T. Fiske. Affect and Cognition. Hillsdale, NJ: Lawrence Erlbaum, 1982.
18.
Coe, Marlana
. Human Factors for Technical Communicators. New York: John Wiley, 1996.
19.
Combs, Arthur W.“Affective Education or None at All.”Educational Leadership39 (1982): 494-497.
20.
Coursey, David
. “Like It or Not, Here Comes Bob 97.”Computerworld19 Aug. 1996: 101-102.
21.
Cross, K. Patricia
. Adults as Learners. San Francisco: Jossey-Bass, 1981.
22.
Den Buurman, Rudy
. “User-Centered Design of Smart Products.”Ergonomics40 (1997): 1159-1169.
23.
Denzin, Norman K.
, and Yvonna S. Lincoln, eds. Strategies of Qualitative Inquiry. Thousand Oaks, CA: Sage, 1998.
24.
Fischer, Gerhard
. “Enhancing Incremental Learning Processes with Knowledge-Based Systems.”Learning Issues for Intelligent Tutoring Systems. Ed. Heinz Mandl and Alan Lesgold. New York: Springer-Verlag, 1988.
25.
Fisher, Julie
. “The Value of Technical Communicator's Role in the Development of Information Systems.”IEEE Transactions on Professional Communication42 (1999): 145-154.
26.
Forbes, Christopher
. “The Role of the Technical Communicator within Organizational Information Development Cycles.”Publications Management Essays for Professional Communicators. Ed. O. Jane Allen and Lynn H. Deming. Amityville, NY: Baywood, 1994. 117-140.
27.
Gerlach, James H.
, and Feng-Yang Kuo. “Understanding Human-Computer Interaction for Information Systems Design.”MIS Quarterly15 (1991): 526-548.
Hackos, JoAnn T.
, and Janice C. Redish. User and Task Analysis for Interface Design. New York: John Wiley, 1998.
30.
Henry, Jim
. “The Value Added by Technical Communicators in Collaborative Writing Situations.”Technical Communication45 (1998): 207-220.
31.
Hirsh, Haym
, Chumki Basu, and Brian D. Davison. “Learning to Personalize.”Communications of the ACM43.8 (2000): 102-106.
32.
Hodder, Ian
. “The Interpretation of Documents and Material Culture.”Collecting and Interpreting Qualitative Materials. Ed. Norman K. Denzin and Yvonna S. LincolnThousand Oaks, CA: Sage, 1998. 110-129.
33.
Holtzblatt, Karen
, and Hugh Beyer. “Making Customer-Centered Design Work in Teams.”Communications of the ACM36.10 (1993): 92-104.
34.
Horvitz, Eric
. “Uncertainty, Action, and Interaction: In Pursuit of Mixed-Initiative Computing.”Intelligent Systems14.5 (1999): 17-20.
35.
Huberman, A. Michael
, and Matthew B. Miles. “Data Management and Analysis Methods.”Collecting and Interpreting Qualitative Materials. Ed. Norman K. Denzin and Yvonna S. Lincoln. Thousand Oaks, CA: Sage, 1998, 179-210.
36.
Iacobucci, Dawn
, Phipps Arabie, and Anand Bodapati. “Recommendation Agents on the Internet.”Journal of Interactive Marketing14.3 (2000): 2-11.
37.
Irvin, Steve
. “Documentation.”InfoWorld13 Nov. 1995: 132-132.
38.
Jacobson, Ivar
. Object-Oriented Software Engineering. Reading, MA: Addison-Wesley, 1994.
39.
Jonassen, David H.“Operationalizing Mental Models: Strategies for Assessing Mental Models to Support Meaningful Learning and Design-Supportive Learning Environments.”Computer Support for Collaborative Learning 95 Conference. Bloomington, IN. 1995. 21 Oct. 2001. http://www.cica.indiana.edu/cscI95/jonassen.html
40.
Kawakita, Jiro
. The Original KJ Method. Tokyo: Kawakita Research Institute, 1982.
41.
Keil, Mark
, and Erran Carmel. “Customer-Developed Links in Software Development.”Communications of the ACM38.5 (1995): 33-44.
42.
Kolb, David A.Experiential Learning: Experience as a Source of Learning and Development. Englewood Cliffs, NJ: Prentice Hall, 1984.
43.
Laurel, Brenda
. Computer as Theater. Reading, MA: Addison-Wesley, 1991.
44.
Lawler, Patricia A.The Keys to Adult Learning: Theory and Practical Strategies. Philadelphia: Research for Better Schools, 1991.
45.
Leonard, Dorothy
, and Jeffrey F. Rayport. “Spark Innovation through Empathic Design.”Harvard Business ReviewNov.-Dec. 1997: 102-113.
46.
Li-Ron, Yael
. “Office Assistant: Dog or Genius?”PC World15.2 (1997): 116-116.
47.
Mandler, George
. Mind and Body. New York: Norton, 1984.
48.
McKeon, Anne
. “Intelligent Assistance and Natural Language Processing Drive New AI.”Computing Canada24.2 (1998):33-33.
49.
Mead, Jay
. “Measuring the Value Added by Technical Documentation: A Review of Research and Practice.”Technical Communication45 (1998): 357-380.
50.
Nielsen, Jakob
. Usability Engineering. San Francisco: Morgan Kaufmann, 1993.
51.
Norman, Donald A.The Design of Everyday Things. New York: Doubleday/Currency, 1989.
52.
Norman, Donald A.“How Might People Interact with Agents.”Communications of the ACM37.7 (1993): 68-71.
53.
Norman, Donald A.“Some Observations on Mental Models.”Mental Models. Ed. Dedre Gentner and Albert L. Stevens. Hillsdale, NJ: Lawrence Erlbaum, 1983.
54.
Norton, David W.“Tech Comm as Business Strategy: A Study of How Changes in Dis-cursive Patterns Affect the Value of Technical Communication in Cross-Functional Team Settings.”Technical Communication47 (2000): 77-89.
55.
Null, Christopher
. “Someone to Watch Over You.”PC Computing13.2 (2000): 44-44.
56.
Parasuraman, A.“Reflections on Gaining Competitive Advantage through Customer Value.”Journal of the Academy of Marketing Science25.2 (1997): 154-161.
57.
Pask, Gordon
. Conversation, Cognition, and Learning. New York: Elsevier, 1975.
58.
Pask, Gordon
. “Styles and Strategies of Learning.”British Journal of Educational Psychology46 (1976): 128-148.
59.
Pine, B. Joseph
, and James H. Gilmore. The Experience Economy: Work Is Theater and Every Business a Stage. Boston: Harvard Business School Press, 1999.
60.
Raven, Mary Elizabeth
, and Alicia Flanders. “Using Contextual Inquiry to Learn about Your Audiences.”Journal of Computer Documentation20 (1996): 1-13.
61.
Reason, Peter
. “Three Approaches to Participative Inquiry.”Strategies of Qualitative Inquiry. Ed. Norman K. Denzin and Yvonna S. Lincoln. Thousand Oaks, CA: Sage, 1998, 261-291.
62.
Redish, Janice C.“Adding Value as a Professional Technical Communicator.”Technical Communication42 (1995): 26-29.
63.
Redish, Janice C.“Minimalism in Technical Communication: Some Issues to Consider.”Minimalism beyond the Nurnberg Funnel. Ed. John M. Carroll. Cambridge, MA: MIT Press, 1998. 219-246.
64.
Redish, Janice C.“Reading to Learn to Do.”IEEE Transactions on Professional Communication32 (1989): 289-293.
65.
Rettig, Marc
. “Nobody Reads Documentation.”Communications of the ACM34.7 (1991): 19-24.
66.
Riecken, Doug
. “Intelligent Agents.”Communications of the ACM37.7 (1994): 18-20.
67.
Rogers, Carl R.
, and H. Jerome Freiberg. Freedom to Learn. 3rd ed.Columbus, OH: Merill/Macmillan, 1994.
68.
Rust, Ronald T.
, and Anthony J. Zahorik. “Customer Satisfaction, Customer Retention, and Market Share.”Journal of Retailing69 (1993): 193-215.
69.
Säljö, Roger
. “Learning Approach and Outcome: Some Empirical Observations.”Instructional Science10 (1981): 47-63.
70.
Schneider, M. L.“Models for the Design of Static Software User Assistance.”Directions in Human/Computer Interaction. Ed. Albert Badre and Ben Shneiderman. Norwood, NJ: Ablex, 1982.
71.
Schuler, Douglas
, and Aki Namioka. Participatory Design: Principles and Practices. Hillsdale, NJ: Lawrence Erlbaum, 1993.
72.
Seol, Kap Su
. “‘Bots’ Support Customer Service.”National Underwriter. 104.4 (2000): 7-7, 16-16.
73.
Setton, Dolly
. “Invasion of the Virbots.”Forbes11 Sep. 2000: 22-26.
74.
Shroyer, Roberta
. “Actual Readers versus Implied Readers: Role Conflicts in Office 97.”Technical Communication47 (2000): 238-240.
75.
Smart, Karl L.“Minimalism: A Quality Strategy for Success.”Minimalism beyond the Nurnberg Funnel. Ed. John M. Carroll. Cambridge, MA: MIT Press, 1998. 312-326.
76.
Smart, Karl L.
, J. L. Madrigal, and Kristie K. Seawright. “The Effect of Documentation on Customer Perception of Product Quality.”IEEE Transactions on Professional Communication39 (1996): 157-162.
77.
Smith, Rebecca M.“Microsoft Bob to Have Little Steam, Analysts Say—Ask if ‘Social Interfaces’ Are the Best Solution.”Computer Retail Week3 Apr. 1995: 37-37.
78.
Soloway, Elliot
, and Amanda Pryer. “The Next Generation of Human-Computer Inter-action.”Communications of the ACM39.4 (1996): 16-16.
79.
Sproull, Lee
, Mani Subramani, Sara Kiesler, Janet H. Walker, and Keith Waters. “When the Interface Is a Face.”Human-Computer Interaction11 (1996): 97-124.
80.
Stewart, Thomas
. Intellectual Capital: The New Wealth of Organizations. New York: Doubleday, 1997.
81.
Suchman, Lucille A.Plans and Situated Actions: The Problem of Human Machine Communication. New York: Cambridge University Press, 1987.
82.
Suchman, Lucille A.“Representations of Work.”Communications of the ACM 38.9 (1995): 56-64.
83.
Van der Meij, Hans
. “ACritical Assessment of the Minimalist Approach to Documentation.”Proceedings of SIGDOC 92 Conference. New York: Association of Computing Machinery, 1992. 7-17.
84.
Van der Meij, Hans
, and John M. Carroll. “Principles and Heuristics for Designing Minimalist Instruction.”Minimalism beyond the Nurnberg Funnel. Ed. John M. Carroll. Cambridge, MA: MIT Press, 1998. 19-53.
85.
Vaughn, Joan E.
, and Katie Walton. “Beyond End-User Documentation: Opportunities for Technical Communicators.”STC Conference Proceedings. Arlington, VA: Society for Technical Communication, 1999. 10 Sep. 2001. http://www.stc-va.org/proceedings/ConfProceed/1999/PDFs/STC-80.pdf
86.
Weiner, Bernard
. “History of Motivational Research in Education.”Journal of Educational Psychology82 (1990): 616-622.
87.
Wood, Larry E.User Interface Design: Bridging the Gap from User Requirements to Design. Boca Raton, FL: CRC Press, 1998.
88.
Yourdon, Edward
, and Larry Constantine. Structured Design. Englewood Cliffs, NJ: Prentice Hall, 1979.
