The Collaborative Construction of a Management Report in a Municipal Community of Practice: Text and Context, Genre and Learning    

Drawing on rhetorical genre studies and recent work in activity system theory, this study focuses on the collaborative development of a new written form, a municipal plan for protecting and managing natural areas. The author advances a twofold claim: (a) that the written plan is developed in the absence of a stable textual model and (b) that the text, as part of the context, functions, in turn, as a mediational tool for solving the rhetorical problem of audience resistance. Findings show that as participants reconfigure the project into successive cycles of activity, they create corresponding zones of proximal development. This study contributes to our understanding of the dynamics of the text-context relationship and to recent elaborations of genre as an activity system that help explain the relationship between genre and learning.

Wegner, Diana. Journal of Business and Technical Communication (2004). Articles>Collaboration>Environmental>Government

Collaborative Document Editing with svk

Say you have a document that needs to be presented in two languages and you are the translator. While the translation is in progress, someone revises the original master document. This means you now might be working with an outdated paragraph or one no longer present in the master version. This article tries to map this problem to parallel development, which version control systems solve with the branch and merge model. You will also see how svk helps you maintain translated documents easily.

Kao, Chia-liang. O'Reilly and Associates (2004). Articles>Content Management>Collaboration>Writing

Collaborative Invention Among Experts in an Interdisciplinary Context: The Creation of Written Discourse for Countermeasures to Biological and Chemical Threats    

Programs in technical and scientific communication educate students from multiple disciplines. As we teach these students from various fields, we often assume they will write to others who are members of the same field. However, professionals commonly communicate across disciplinary boundaries and collaborate with those who do not necessarily belong to their field. We should rethink our approaches in teaching scientific and technical communication to consider how different peoplefrom different areas of expertise engage one another in a communication situation. Based on the understanding that different disciplinary cultures and languages alter contexts for communication, astudy examining how experts from science, engineering, mathematics, and architecture come together as a single group and collaboratively invent discourse can contribute to new knowledge to inform curriculum development.

Gooch, John C. CPTSC Proceedings (2001). Articles>Risk Communication>Collaboration

Collaborative Projects in a Technical Writing Class: A Cost/Benefit Analysis    

With the shift in writing pedagogy from product to process, from emphasizing the individual writing--in a vacuum--to emphasizing the social context and social nature of writing, collaboration of some sort has found a place in most writing classes. The inclusion of collaborative projects in technical writing courses has a second, practical justification: the idea that these courses should prepare students for writing on the job, where collaborative writing is common.

Brumberger, Eva R. NCTE TETYC (1999). Articles>Education>Collaboration

Combining Interpersonal and Technical Communication Courses to Improve How Teams Function  

Research indicates that teams are more effective when they satisfy the social goals of their members. Therefore, teams that focus on interpersonal communication (the internal performance process) as well as the team's objective (the external product) improve their chances for success. It follows, then, that classroom instructors can enhance team success by adding interpersonal communication components to courses that use teams. This paper shows how we used this research to design an innovative NSF program. The program incorporated an interpersonal communication component to motivate student teams to succeed.

Barchilon, Marian G. and Donald G. Kelley. STC Proceedings (1994). Articles>Education>Collaboration

Comics: Not Just for Laughs!

Every project has its own unique set of 'opportunities'--also known as challenges. Many of these challenges relate not to the quality of our work, but rather to the communication of our ideas. Often in the course of design, you must communicate complicated concepts to a non-technical (and often uninterested) project sponsor, client, or stakeholder. So how do you capture their interest, get their understanding and buy-in, and finally move on?

Sedaca, Rebekah. Boxes and Arrows (2007). Articles>Project Management>Collaboration>Technical Illustration

Communicating Effectively with Your Web Developer

A rather stressful part of optimizing some sites can be working with a web developer who doesn't understand the importance of search engine friendly design. Sometimes these developers can be frustrating or keep you from getting your work done right. This article contains a number of thing to keep in mind and to avoid when working in these situations.

Sullivan Cassidy, Jennifer. SEOchat (2005). Articles>Web Design>Collaboration

Communication Channels Used by Technical Writers Throughout the Documentation Process    

This article focuses on communication channels used by technical writers to obtain and verify product information. Although much has been written about communication channel components (for example, document review), little discussion has focused on the spectrum of communication channels available to technical writers or why they might choose certain channels. The communication channels identified in this article include team meetings, document review, individual face-to-face meetings, phone calls, and e-mail. To test my identification and to see which channels writers would choose when presented with different scenarios, I collected and analyzed data from a survey of approximately 30 technical communicators who responded to an e-mail questionnaire sent to 170 STC members.

McGee, Lynn. Technical Communication Online (2000). Articles>Communication>Collaboration

Communication in Cross-Functional Teams: An Introduction to This Special Issue    

The importance of teams has grown during the past decades as increasing numbers of organizations have turned to collaborative models of work. The emphasis on 'cross-functional' reflects the growing complexity of today's work, where no single individual or job function possesses sufficient knowledge or skill for developing or maintaining innovative products and services. One of the biggest challenges of teams is developing patterns of effective communication. As with all processes and practices in the workplace, communication within cross-functional teams must be examined, discussed, and taught explicitly for such teams to succeed. The articles in this issue provide insights into the communication challenges facing individuals working in teams in today's workplace. In addition, the issue discusses a variety of tools and techniques for improving communication and efficiency within teams and the quality of work produced.

Smart, Karl L. and Carol M. Barnum, eds. Technical Communication Online (2000). Articles>Communication>Collaboration

Communication Patterns Between Organizations: Implications for the Classroom  

Because many corporations now outsource significant portions of their business to external companies, it is important to study and understand the role of writing and, more generally, differing communication structures between organizations. In my experience, this is not a topic that is discussed in most technical communication classrooms.

McCord, Michael. CPTSC Proceedings (2003). Articles>Education>Communication>Collaboration

The Complexity of Online Groups: A Case Study of Asynchronous Collaboration    

Work preparing documents is increasingly being done by diverse, geographically separated project teams. This essay describes some of the characteristics of such collaboration and applies them to a case study involving a team composing a mission statement. The group succeeded in their task, even though shortcomings inherent in asynchronous, distributed collaboration did lead to some problems.

Chandler, Hope E. Journal of Computer Documentation (2001). Articles>Collaboration>Telecommuting

Conducting Successful Interviews With Project Stakeholders

A simple, semi-structured, one-on-one interview can provide a very rich source of insights. Interviews work very well for gaining insights from both internal and external stakeholders, as well as from actual users of a system under consideration. Though, in this column, I'll focus on stakeholder interviews rather than user interviews.

Baty, Steve. UXmatters (2007). Articles>Collaboration>Interviewing

Confidentiality and Privilege in Mediation: A Dutch Perspective  

It is the author's bold submission, that Dutch case law, as developed by the Netherlands Supreme Court, might be of some general interest, as it is based on general principles, amongst others found in case law by the European Court for Human Rights. As Dutch is not Europe's most accessible language, some observations in English might be stimulating for those who are interested in this matter.

Bosnak, John. Mediate.com (2002). Articles>Collaboration>Regional>Netherlands

Conflict and Communication: The Good Will Hunting Technique

In the self-help section of bookstores, there is abundant advice for communication in everyday situations--with bosses, parents, children, lovers and even animals. Worthwhile advice is to be found, but there also exists a prominent strain of advice that offers solutions that actually worsen the problem.

Cesaratto, Todd. Communication Currents (2007). Articles>Communication>Collaboration

Conflict Styles and Technical Communicators  

More than most people, technical communicators are aware that if communication is not effective, conflicts can arise. Find out more about the Thomas-Kilmann conflict mode instrument (TKI) and how to identify your predominant conflict style.

Glick-Smith, Judith L. Intercom (2007). Articles>Collaboration>Methods

Connectfulness

In the same way that the word 'truthiness' is not a real word but is gaining usage in our culture, so the word 'connectfulness' offers us in the professional arena a way to express an important aspect of our work. Just as truthiness says more than accuracy and is friendlier than truthfulness, so connectfulness says more than networked and is friendlier and more inclusive than connectedness.

Albing, Bill. Carolina Communique (2006). Articles>Content Management>Collaboration

Connecting Cultures, Changing Organizations: The User Experience Practitioner As Change Agent

Every time we reach across discipline boundaries to keep a product team focused on users, drive changes to products or services based on user data we've collected, or design interactions with a clear focus on the target user, we are functioning as agents of change within our organizations.

Sherman, Paul J. UXmatters (2007). Articles>User Experience>Collaboration

Content Re-Use with the Tools at Hand  

Frequent updates for a swarm of modular plug-ins were interrupting work on larger, higher-value projects. Worse, development was happening in a time zone 12 hours away, making communication a major bottleneck. Faced with fixed resources and growing commitments, our writing group extended existing tools to automate information gathering and rough draft creation, thereby halving the writer time each module required. This paper describes the user interface, tool extensions, and reusable information approach we used to solve the problem.

Carpenter, Cory, Samantha Lizak and Jeffrey Young. STC Proceedings (2005). Articles>Content Management>Collaboration

Contracts 101

Contracts are the oil that keeps business running smoothly. If you are running your own web design business, you should think of a contract as a business tool that can help you communicate clearly with your clients.

Fine, Scott. Wise-Women (2004). Articles>Collaboration>Contracts

CoverWeb? Adding Multiple Authorship to Multi-Linearity  

This multi-vocality and multiple authorship allows an enactment of some of the collaboratory promise of hypertext while web publishing allows decentralized publication. Finally, the CoverWeb allows Kairos to deliver texts appropriate to many tiers of readers. This issue's CoverWeb on educational MOOs includes basic introductions to MOOing linked to discussions of the pedagogical possibilities of virtual spaces linked to problems of administering MOOspaces. We have tried to cover a spectrum of possible interests as well as familiarity to MOOs in education and this layering simply wouldn't be possible in print.

Salvo, Michael J. Kairos (1996). Articles>Collaboration>Online

Creating an Editing Policy  

As an editor, you realize how important it is to edit information consistently. What you might not realize how important it is to let the writer know how you are going to edit, what you are going to edit, and what you expect from the writer. An editing policy lets you communicate these things to the writer. When you and the writer know what to expect from each other, you are able to work together as a team to produce a quality document.

Reed, Wendy L. STC Proceedings (1994). Articles>Editing>Collaboration

Creating, Implementing, and Maintaining Corporate Style Guides in an Age of Technology    

This article details a step-by-step process for creating, implementing, and maintaining a corporate style guide to ensure consistency in organizational communication. Through literature research, analysis of sample style guides, and practitioner interviews, this article provides recommendations for gaining management support, building a process to develop a style guide, determining content, encouraging employee buy-in, and maintaining a corporate style guide.

Bright, Mark R. Technical Communication Online (2005). Articles>Editing>Style Guides>Collaboration

Creating the Out-of-the-Box Experience: A Case Study  

While producing a new deliverable to improve the out-of-the-box experience for a major software product, the team of writers, graphic designers, human factors engineers, and marketers responsible for the deliverable faced many challenges and overcame many obstacles. Anyone involved in the production of such a deliverable will learn from a discussion of the problems we faced and the approaches we took to solving them. This discussion will be particularly relevant for anyone creating such a deliverable for the first time.

Hogan, Tim. STC Proceedings (2001). Articles>TC>User Experience>Collaboration

Review: Culture, Technology, Communication: Towards an Intercultural Global Village  

The Internet is continually changing how we think about "the office." Online media now allow us to exchange information with overseas colleagues almost as quickly and as easily as we can with coworkers located across the hallway from our workstations. This new degree of access, however, means that cultural differences could affect workplace interactions.

St. Amant, Kirk R. Technical Communication Online (2004). Articles>Reviews>Collaboration>International

Customer Partnering: Data Gathering for Complex Online Documentation  

Technical communicators today must document complex applications used in complex environments. Information about users and use models is important under these conditions, especially if documentation will be presented online. Customer partnering, a method of information gathering that supplements surveys, contextual inquiries, usability testing, and interviews, provides a way of involving the users of complex applications in the design of information delivery systems. We used this method to help a client gather important information about user and use models and design a new information library for complex server computer systems.

Hackos, JoAnn T., Molly Hammar and Arthur Elser. ComTech Services (1997). Articles>Documentation>User Centered Design>Collaboration