Collaboration between Writers and Graphic Designers in Documentation Projects

Abstract

Few, if any, studies on collaboration examine interactions between software manual writers and graphic designers. This study analyzes these collaborations, inquiring into the ways in which writers' and designers' processes of collaboration directly affect the form and substance of a finished manual. We argue that when these developers have dialogue, draft iteratively, and jointly make decisions, they produce manuals that could not possibly be developed through linear, assembly-line collaborative processes. We characterize three possible models of collaboration—assembly line (linear drafting), swap meet (iterative drafting and joint problem solving), and symphony (codevelopment in every aspect)—and use as a case study our own collaboration in developing a manual, detailing the concerns that writers and designers bring to a manual project. Analyzing our collaboration as an example of a swap-meet model, we examine four design problems that we faced and explain the ways in which our collaborative processes uniquely shaped our solutions to these problems.

Get full access to this article

View all access options for this article.

References

Allen, Nancy , et al.

“What Experienced Collaborators Say about Collaborative Writing.”

JBTC 1.2 (1987): 70-90.

Bacon, Terry R.

“Collaboration in a Pressure Cooker.”

Bulletin of the Association for Business Communication 53 (1990): 4-8.

Beard, John D. , and Jone Rymer . “The Contexts of Collaborative Writing.” Bulletin of the Association for Business Communication 53 (1990): 1-3.

Bednar, Ann K. , et al.

“Theory into Practice: How Do We Link?”

Constructivism and the Technology of Instruction. Ed. Thomas M. Duffy and David H. Jonassen . Hillsdale, NJ: Lawrence Erlbaum, 1992. 17-34.

Bosley, Deborah S.

“Designing Effective Technical Communication Teams.”

Technical Communication 38 (1991): 504-512.

Brown, John Seeley , Allan Collins , and Peter Duguid . “Situated Cognition and the Culture of Learning.” Educational Researcher 18 (1989): 32-42.

Burnett, Rebecca E.

“Substantive Conflict in a Cooperative Context: A Way to Improve the Collaborative Planning of Workplace Documents.”

Technical Communication 38 (1991): 531-539.

Couture, Barbara , and Jone Rymer . “Interactive Writing on the Job: Definitions and Implications of `Collaboration.' ” Writing in the Business Professions. Ed. Myra Kogen . Urbana, IL: National Council of Teachers of English and Association of Business Communication, 1989. 73-93.

Cross, Geoffrey A.

“The Interrelation of Genre, Context, and Process in the Collaborative Writing of Two Corporate Documents.”

Writing in the Workplace: New Research Perspectives. Ed. Rachel Spilka . Carbondale: Southern Illinois University Press, 1993. 141-152.

10.

Debs, Mary Beth . “Recent Research on Collaborative Writing in Industry.” Technical Communication 38 (1991): 476-484.

11.

Doheny-Farina, Stephen . Rhetoric, Innovation, Technology. Cambridge, MA: MIT Press, 1992.

12.

Duin, Ann Hill . “Terms and Tools: A Theory and Research-Based Approach to Collaborative Writing.” Bulletin of the Association for Business Communication 53 (1990): 45-50.

13.

Ede, Lisa , and Andrea Lunsford . Singular Texts/Plural Authors: Perspectives on Collaborative Writing. Carbondale: Southern Illinois University Press, 1990.

14.

Farkas, David . “Collaborative Writing, Software Development, and the Universe of Collaborative Activity.” Collaborative Writing in Industry: Investigations in Theory and Practice. Ed. Mary M. Lay and William M. Karis . New York: Baywood, 1990. 13-30.

15.

Forman, Janis . “Collaborative Business Writing: A Burkean Perspective for Future Research.” Journal of Business Communication 28 (1991): 233-257.

16.

Keller-Cohen, Deborah , Bruce Ian Meader , and David W. Mann . “Redesigning a Telephone Bill.” Information Design Journal 6.1 (1990): 45-66.

17.

Mirel, Barbara , Susan Feinberg , and Leif Allmendinger . “Strategies for Designing Manuals for Active Styles of Learning.” Technical Communication 38 (1991): 22-33.

18.

Morgan, Meg . “The Group Writing Task: A Schema for Collaborative Assignment Making.” Professional Communication: The Social Perspective. Ed. Nancy Roundy Blyler and Charlotte Thralls . Newbury Park, CA: Sage, 1993. 230-243.

19.

O'Donnell, A. , et al.

“Cooperative Writing: Direct Effects and Transfer.”

Written Communication 2 (1985): 307-315.

20.

Olson, Judith , et al.

“How a Group-Editor Changes the Character of a Design Meeting as Well as Its Outcome.”

Computer-Supported Cooperative Work 92. Proc. of the Conference on Computer Supported Cooperative Work, Toronto. 31 Oct.-4 Nov. 1992. New York: Association for Computing Machinery, 1991. 91-98.

21.

Schon, Donald . The Reflective Practitioner. New York: Basic Books, 1983.

22.

Schrage, Michael . Shared Minds. New York: Random, 1990.

23.

Spilka, Rachel . “Collaboration across Multiple Organizational Cultures.” Technical Communication Quarterly 2 (1993): 125-145.

24.

Suchman, Lucille Alice . Plans and Situated Actions. Cambridge: Cambridge University Press, 1987.

25.

Sullivan, Patricia . “Collaboration between Organizations: Contributions Outsiders Can Make to Negotiation and Cooperation During Composition.” Technical Communication 38 (1991): 485-492.

26.

Trimbur, John . “Consensus and Difference in Collaborative Learning.” College English 51 (1989): 602-616.

27.

Wilson, David . “Diagonal Communication Links within Organizations.” Journal of Business Communication 29 (1992): 129-143.

28.

Wulff, Wendie . “Designing Collaborative User Interfaces: Lessons from Writer/Graphic Designer Interaction.” SIGCHI Bulletin 21 (January 1990): 60-63.