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.