Managing a Distributed Documentation Group  

A distributed documentation group is one in which people work together from distant locations, The new problem in managing such a group is that casual, face-to-face communication is missing. Technological solutions include source control, email, groupware, telephone, and the World Wide Web. Human solutions may be even more important. Autonomy, explicit standards, various ways to meet, and deliberately working across locations build the necessary communications and trust.

Jackson, Ken. STC Proceedings (1996). Presentations>Management>Collaboration>Online

Managing a Documentation Project from Both Sides of the Atlantic  

Most of us struggle every day with keeping the lines of communication open between developers, subject matter experts (SMEs), customers, and writers. Sometimes you can circumvent these difficulties by simply walking upstairs or across the hall and chatting with the appropriate person. But what happens when it's not a staircase or hallway separating you but a very large ocean? The best way to keep an overseas project on track is to put together a writing team in the most convenient location; meet at least once with the development team; and set up your communication channels early.

Morgan, Sharon. STC Proceedings (1998). Articles>Documentation>Collaboration>Online

Managing Chapter Competitions  

Holding competitions at regional and local levels enhances the value a chapter provides its members. This workshop, designed for chapter leaders and competition managers, provides a practical and well-tested plan for managing the chapter’s annual competition. Attendees will receive a complete package of samples, spreadsheet and document templates, and presentation slides that they can customize for their chapters.

Levander, Deanne K. and Preeti Mathur. STC Proceedings (2004). Articles>Collaboration>Community Building>STC

Managing Conflict

Conflict is characteristic in any situation that brings diverse groups together to manage tasks and obstacles. Nowhere is that more apparent than in business environments based on hierarchical structures where teams are inherited and divergent objectives create barriers to effective teamwork. Conflict resolution is among the many tasks delegated to managers, yet it is often the most difficult to master.

Harris, Kerri. Writing Assistance (2007). Articles>Management>Collaboration>Workplace

Managing Content: Version Control in a Collaborative Workplace  

The increasingly collaborative nature of the workplace--including writing teams and documentation groups--heightens the need for sophisticated document management solutions. Written for managers of workgroups and writing/editorial leads, this paper examines some common issues, including version control, document lifecycle management, and support for collaborative authoring and review. This paper also presents a model for finding and implementing a technology solution that makes sense for your team, as well as a case study of a successful implementation.

Angier, Jenny and Paul Foy. STC Proceedings (2005). Articles>Content Management>Collaboration

Managing Enterprise Content: A Unified Content Strategy  

Today's businesses are overwhelmed with the need to create more content, more quickly, customized for more customers and for more media than ever before. Combine this with decreasing resources, time, and budgets and you have a stressful situation for organizations and their content creators. To reduce the costs of creating, managing, and distributing content and to ensure content effectively supports your organizational and customer needs, organizations can benefit from a unified content strategy. A unified content strategy is a repeatable method of identifying all content requirements up front, creating consistently structured content for reuse, managing that content in a definitive source, and assembling content on demand to meet your customers' needs.

Rockley, Ann. E-Doc (2002). Design>Content Management>Collaboration>Content Strategy

Managing Means Growing with Your Team  

Technical communication managers are faced with common responsibilities from company to company. Typically, they are responsible for resources (people and equipment), customer relations (internal and external), product, and administration. To successfully complete these responsibilities, a manager must have people, communication, planning, technical, statistical, and financial accounting skills. While focusing on the skills necessary to meet these responsibilities, managers may loose sight of key writing skills. Well-rounded managers must stay current with their teams. They must grow for their teams to grow.

Jahnke, Jean M. STC Proceedings (1999). Careers>Management>Collaboration

Managing Multiple Deliverables with a Small Staff  

Managing multiple deliverables with a small staff is a discipline unto itself, different from those departments where each writer has specific responsibilities. In this environment, each member is required to have multiple skills and the flexibility to jump from one project to the next quickly. Because of the demands, heavy training costs are often incurred, and the involvement of other departments is mandatory, all of which makes management support essential. It is an exhilarating, often exhausting environment, but the rewards are multiple skills, a wide variety of assignments, and the satisfaction of being part of a tightly-knit, highly-productive team.

Beadle, Diane. STC Proceedings (1999). Articles>Collaboration>Workflow

Managing Scientific and Technical Information In Environmental Cases: Principles and Practices for Mediators and Facilitators  

An attempt to distill and disseminate key principles and practices relevant to managing scientific and technical information in environmental conflicts.

Adler, Peter, Robert Barrett, Martha Bean, Juliana Birkhoff, Connie Ozawa and Emily Rudin. Mediate.com (2002). Careers>Collaboration

Managing SMEs - Part 2: Selling the Concept to Management

Part 2 switches the focus to members of your management team and what you can do to sell your team’s professionalism. Also included are hints on how your writers can individually sell themselves to gain cooperation from SMEs.

Rastocny, Philip. Writing Assistance (2007). Articles>Management>Collaboration>SMEs

Managing the Client: A Fairy Tale

Remember that a successful project has a measurable and positive impact on the client's business objectives. Set a time period to measure the progress toward achieving those objectives, and plan to measure progress on a regular basis. If you find that there are adjustments that should be made, or additions that can improve the project's functionality, do them.

Cliver, Sara. Digital Web Magazine (2002). Careers>Consulting>Collaboration

Managing the Communication Between Writers and SMEs  

The development of a modern software product is a complex process involving a variety of disciplines, including that of the technical writer. It is essential that the writers establish close relationships with all other groups in the process and that they build effective and efficient systems of communication between them. The job of the writing manager is to ensure that the writing team obtains the information it needs in a timely manner and that the group interacts effectively with other groups in the process. This can be achieved by a blend of intergroup communication, background research, documentation and schedule planning and a well organized documentation review process.

Morgan, Sharon. STC Proceedings (1998). Articles>TC>Collaboration>SMEs

Managing Virtual Teams: Getting the Most from Wikis, Blogs, and Other Collaborative Tools--Interview with the Authors

I talk with Katherine (Kit) Brown, Brenda Huettner, and Char James-Tanny about their latest book, Managing Virtual Teams: Getting the Most from Wikis, Blogs, and Other Collaborative Tools.

Brown, M. Katherine 'Kit', Brenda P. Huettner, Char James-Tanny and Tom H. Johnson. Tech Writer Voices (2007). Articles>Collaboration>Content Management>Podcasts

Managing--and Surviving--A Design Project  

Describes a process for designing documents that establishes clear goals and minimizes disagreements.

Harvey, Patrick. Intercom (2001). Design>Project Management>Collaboration

Many Heads Make Work Right

Writing is popularly considered a spontaneous exercise, and often is. Spontaneous writing, however, does not always result in high quality results.

Aiyyangar, Ramesh. Indus (2002). Articles>Writing>Collaboration>Technical Writing

Marketing Yourself as a Marketing Writer  

Technical communication consultants may find that marketing writing makes an excellent second line of business. Technology companies, marketing services firms, and advertising agencies often use freelancers to write marketing documents. They particularly need good writers who understand technology. This paper discusses the business of freelance marketing writing and how it differs from independent technical writing. Topics include the kinds of projects that marketing writers work on, how development cycles typically differ from those of technical documents, and how to effectively market yourself as a marketing writer.

Massa, Jack A. STC Proceedings (2002). Careers>Collaboration>Marketing>Business Communication

Marketing Yourself as a Technical Communicator  

No matter what your current status—employee, looking for a job, or independent consultant—marketing yourself is necessary. Marketing is determining what your customers need and then showing how whatever you are selling meets those needs, i.e., provides benefits, and does it better than the competition. When you market yourself, you are basically doing the same thing. If you are an employee, how are you developing your skills so they continue to meet the changing needs of your employer? If you are looking for a job, how does what you bring to the table make you a better candidate than everyone else? If you are an independent, how do you benefit your clients so they turn to you over and over again?

Teich, Thea. STC Proceedings (2002). Careers>TC>Collaboration

Mediating Group Dynamics through Tabletop Interface Design  

Our tabletop research efforts at Stanford University have focused on how tabletop user interfaces (UIs) might respond to and even influence a user group's social dynamics.

Morris, M.R., Piper, A.M., Cassanego, A., Huang, A., Paepcke, A., and Winograd, T. Stanford University (2006). Articles>Collaboration>User Interface

A Mentoring Program for Web Designers  

Creating a mentoring program for technical writers requires quite a bit of coordination.

Leonard-Wilkinson, Theresa A. Intercom (2001). Careers>Collaboration>Mentoring

Merging XML Files: A New Approach Providing Intelligent Merge of XML Data Sets  

As XML becomes ubiquitous so the need for powerful tools to manipulate XML data becomes more pressing. Merging XML is particularly tricky, but often necessary to consolidate data feeds from heterogeneous systems, or to synchronize submissions of XML fragments which make up a larger document. An automated mechanism for defining and controlling such merges has been developed and is demonstrated to provide a consistent, adaptable and resilient solution to this problem. Integration into an information pipeline allows limitless customization.

La Fontaine, Robin. DeltaXML.com (2001). Articles>Information Design>XML>Collaboration

The Methodology of Participatory Design    

Technical communicators have lately become interested in participatory design as a way to structure and guide their research and development efforts, particularly in online media. But attempts to use participatory design - in technical communication and elsewhere - have been hampered because participatory design has typically been seen as an orientation or field rather than a methodology with its own methods, techniques, and acceptable range of research designs. In this article, I work with a range of participatory design sources to describe it as a methodology useful for technical communicators. After providing the historical and methodological grounding for understanding participatory design as a methodology, I describe its research designs, methods, criteria, and limitations. Finally, I provide guidance for applying it to technical communication research.

Spinuzzi, Clay. Technical Communication Online (2005). Articles>Collaboration>Methods>Participatory Design

Monitoring Communication in Partnering Projects

This report is a summary of a two year research project carried out by the IT byg group at BYG. DTU for the Danish government agencies Erhvervsfremmestyrelsen and By- og Bolig-ministeriet. The objectives were to collect data on the use of IT by the PPB housing consortia, a development project to test out various innovations, to map communications between the partners, and compare IT usage with their original proposals. Data was collected on communications in housing projects in the period June 1999- Aug 2000. The original PPB proposals were made in 1994/5 but there have been breaks in the flow of projects, and information technology has gone through much change since then. Use of Email has taken over from post and fax, and Project Webs have been developed in most consortia. Consortium members' policies have dominated the choice of management and logistics software, restricted compatibility in the consortia, and limited willingness to share data. Greater involvement by the client, and more sharing of equity, would have encouraged adoption of common IT systems and created more trust for data sharing between partners. PPB projects have allowed consortium members to test out new technologies but, in general, the IT systems used have been similar to those which the larger firms use elsewhere. Vertical integration has been limited by lack of experience and technology in smaller firms. In future, access to Project Webs from mobile devices should help use by all partners from any location. In all the projects studied, and in spite of the introduction of Email and Project Webs, the ratio of non-IT communications to IT varied from 0.8 to 4.6. When problems need to be solved rapidly there appears to be a tendency to revert to traditional means of communication - meetings, telephone and fax.

Howard, Rob and Ernst Petersen. ITcon (2001). Articles>Collaboration>Community Building>Government

The Most Non-Boring Article About The UPA Board Ever

A quick overview of the Usability Professionals Association Board--what functions it performs, how it's structured, and who's currently performing what role.

Sherman, Paul J. Usability Professionals Association (2006). Articles>Usability>Collaboration

Moving Between Academe and Industry: Lessons Learned  

The author discusses her transition from academic professor to corporate worker and back to academic professor. She compares and contrasts some fundamental differences between these environments on the dimensions of teaching, research, collaboration, problem solving, and ethics. She describes some of the lessons she learned as she moved back and forth across these environments. She concludes by suggesting that, however large these transitions seem, they are transitions we routinely expect our students to make when they migrate from school to work.

Levine, Barbara J. STC Proceedings (2003). Articles>Collaboration>Industry and Academy

Moving to Single Sourcing: Managing the Effects of Organizational Changes    

Argues that the move to single sourcing often requires changes within teams as new skills are introduced and members' roles shift. Points out that while some changes may threaten the stability of the team, managers can anticipate and prevent problems.

Bottitta, Jeanette, Alexia Prendergast Idoura and Lisa Pappas. Technical Communication Online (2003). Articles>Content Management>Single Sourcing>Collaboration