Using customer data to drive documentation design decisions

Journal of Business and Technical Communication

Volumn 16, Issue 2, 2002, Pages 115-169

  Smart, Karl L ^a   Whiting, Matthew E ^b  

^a CENTRAL MICHIGAN UNIVERSITY   (United States)

^b MICROSOFT   (United States)

Author keywords

[No Author keywords available]

Indexed keywords

EID: 0036243793     PISSN: 10506519     EISSN: None     Source Type: Journal    
DOI: 10.1177/1050651902016002001     Document Type: Review

References (88)

1. Alpert, Bill. "TroubleClick." Barron's 3 July 2000: 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 ACM 37.7 (1994): 122-25.
4. Beabes, Minette A., and Alicia Flanders. "Experiences with Using Contextual Inquiry to Design Information." Technical Communication 42 (1995): 409-20.
5. Bernhardt, Stephen A., and George M. McCulley. "Knowledge Management and Pharmaceutical Development Teams: Using Writing to Guide Science." Technical Communication 47 (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 Olftnan, and Maung K. Sein. "The Importance of Learning Style in End-User Training." MIS Quarterly 14 (1990): 100-19.
8. Bradford, David B. "The New Role of Technical Communication." Technical Communication 32 (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 Communication 38 (1991): 214-20.
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.
12. Carroll, John M. Minimalism beyond the Nurnberg Funnel. Cambridge, MA: MIT Press, 1999.
13. _. 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 Eribaum, 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 Leadership 39 (1982): 494-97.
20. Coursey, David. "Like It or Not, Here Comes Bob 97." Computerworld 19 Aug. 1996: 101-02.
21. Cross, K. Patricia. Adults as Learners. San Francisco: Jossey-Bass, 1981.
22. Den Buurman, Rudy. "User-Centered Design of Smart Products." Ergonomics 40 (1997): 1159-69.
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 Communication 42 (1999): 145-54.
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-40.
27. Gerlach, James H., and Feng-Yang Kuo. "Understanding Human-Computer Interaction for Information Systems Design." MIS Quarterly 15 (1991): 526-48.
28. Grech, Christine. "Computer Documentation Doesn't Pass Muster. " PC Computing 5.4 (1992): 212-14.
29. 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 Communication 45 (1998): 207-20.
31. Hirsh, Haym, Chumki Basu, and Brian D. Davison. "Learning to Personalize." Communications of the ACM 43.8 (2000): 102-06.
32. Hodder, Ian. "The Interpretation of Documents and Material Culture." Collecting and Interpreting Qualitative Materials. Ed. Norman K. Denzin and Yvonna S. Lincoln. Thousand Oaks, CA: Sage, 1998. 110-29.
33. Holtzblatt, Karen, and Hugh Beyer. "Making Customer-Centered Design Work in Teams." Communications of the ACM 36.10 (1993): 92-104.
34. Horvitz, Eric. "Uncertainty, Action, and Interaction: In Pursuit of Mixed-Initiative Computing." Intelligent Systems 14.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 Marketing 14.3 (2000): 2-11.
37. Irvin, Steve. "Documentation." InfoWorld 13 Nov. 1995: 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 ACM 38.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 Review Nov.-Dec. 1997: 102-13.
46. Li-Ron, Yael. "Office Assistant: Dog or Genius?" PC World 15.2 (1997): 116.
47. Mandler, George. Mind and Body. New York: Norton, 1984.
48. McKeon, Anne. "Intelligent Assistance and Natural Language Processing Drive New AI." Computing Canada 24.2 (1998): 33.
49. Mead, Jay. "Measuring the Value Added by Technical Documentation: A Review of Research and Practice." Technical Communication 45 (1998): 357-80.
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. _. "How Might People Interact with Agents." Communications of the ACM 37.7 (1993): 68-71.
53. _. "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 Discursive Patterns Affect the Value of Technical Communication in Cross-Functional Team Settings." Technical Communication 47 (2000): 77-89.
55. Null, Christopher. "Someone to Watch Over You." PC Computing 13.2 (2000): 44.
56. Parasuraman, A. "Reflections on Gaining Competitive Advantage through Customer Value." Journal of the Academy of Marketing Science 25.2 (1997): 154-61.
57. Pask, Gordon. Conversation, Cognition, and Learning. New York: Elsevier, 1975.
58. _. "Styles and Strategies of Learning." British Journal of Educational Psychology 46 (1976): 128-48.
59. Fine, 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 Documentation 20 (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-91.
62. Redish, Janice C. "Adding Value as a Professional Technical Communicator." Technical Communication 42 (1995): 26-29.
63. _. "Minimalism in Technical Communication: Some Issues to Consider." Minimalism beyond the Nurnberg funnel. Ed. John M. Carroll. Cambridge, MA: MIT Press, 1998. 219-46.
64. _. "Reading to Learn to Do." IEEE Transactions on Professional Communication 32 (1989): 289-93.
65. Rettig, Marc. "Nobody Reads Documentation." Communications of the ACM. 34.7 (1991): 19-24.
66. Riecken, Doug. "Intelligent Agents." Communications of the ACM 37.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 Retailing 69 (1993): 193-215.
69. Säljö, Roger. "Learning Approach and Outcome: Some Empirical Observations." Instructional Science 10 (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, 16.
73. Setton, Dolly. "Invasion of the Virbots." Forbes 11 Sep. 2000: 22-26.
74. Shroyer, Roberta. "Actual Readers versus Implied Readers: Role Conflicts in Office 97." Technical Communication 47 (2000): 238-40.
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-26.
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 Communication 39 (1996): 157-62.
77. Smith, Rebecca M. "Microsoft Bob to Have Little Steam, Analysts Say - Ask if 'Social Interfaces' Are, the Best Solution." Computer Retail Week 3 Apr. 1995: 37.
78. Soloway, Elliot, and Amanda Fryer. "The Next Generation of Human-Computer Interaction." Communications of the ACM 39.4 (1996): 16.
79. Sproull, Lee, Mani Subramani, Sara Kiesler, Janet H. Walker, and Keith Waters. "When the Interface Is a Face." Human-Computer Interaction 11 (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. _. "Representations of Work." Communications of the ACM 38.9 (1995): 56-64.
83. Van der Meij, Hans. "A Critical 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 Psychology 82 (1990): 616-22.
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.