A directory of resources inthe field of technical communication (and technical writing).

Articles>Collaboration>Technical Writing

35 found. Page 1 of 2.

About this Site | Advanced Search | Localization | Site Maps

1 2  NEXT PAGE »



Being Personal isn't About Being Their "Buddy"

I have written often about the value of writing online in a personal voice. In particular, emails and newsletters lend themselves to a genuine, personal tone.

Usborne, Nick. Excess Voice (2004). Articles>Collaboration>Writing>Technical Writing


Collaborative Authoring and Technical Writing

Writing is a complex, cyclical task. The writing task requires more than formulating text to express ideas, it involves data gathering, managing constraints, formulating intentions, planning, and revising goals. Much of the complexity is due to the management of simultaneous activities and constraints. Management of these processes can lead to 'cognitive overload', which in turn can negatively affect the quality of the text produced. With technical writing, these same issues of task complexity are applicable.

Spring, Michael. University of Pittsburgh (1997). Articles>Writing>Technical Writing>Collaboration


Collaborative Walkthrough Video

Collaborative walkthroughs are a technique that my team used while rewriting our Help and adopting DITA. We believe that we were able to improve the user experience by improving the collaborative experience.

Bennett, Miranda. On Writing (2008). Articles>Documentation>Collaboration>Technical Writing


Conducting Effective Team Technical Reviews

Mention team technical reviews to a group of tech writers and chances are good that you will either get a loud, collective groan, or the group will vie to tell the best review horror story. On the one hand, technical reviews are a vital part of our jobs because they help us to produce high quality product documents. On the other hand, technical reviews gone wrong are the bane of our existence. The good news is that we have the power to conduct consistently effective technical reviews. This article summarizes why we do reviews and what often goes wrong in reviews, and then summarizes steps to take before, during, and after technical reviews that can help you conduct effective team technical reviews. Although your process and team may differ from what’s described here, you can apply the information in part or in whole to improve your current review process.

Brown, M. Katherine 'Kit'. Tech Writer Today (2011). Articles>Collaboration>Technical Writing>Assessment


Cures for the Information Exclusion Complex

Some years ago, I used to suffer from developer neglect, or to use a more scientific term, from a kind of information exclusion complex. You know what I’m talking about. Developers make updates to the interface, often at the last minute, and don’t let the tech writer know what changed. As a result, the help is wrong and out of date. It’s a frustrating experience from the writer’s perspective.

Johnson, Tom H. I'd Rather Be Writing (2010). Articles>Collaboration>Technical Writing>SMEs


Foregrounding Positive Problem-Solving Teamwork: Awareness and Assessment Exercises for the First Class and Beyond   (peer-reviewed)   (members only)

In an advanced technical and professional writing course, a pair of in-class exercises integrates the teaching of teamwork with other class topics of project management and observation-based research. The first exercise introduces teamwork in a positive way, by raising awareness of strategies for solving problems successfully. The second exercise follows up on the first, focusing on assessment of problem-solving teamwork. The pair of exercises is memorable and effective, showing students in an engaging, thought-provoking way that they have control and responsibility for the success of their teamwork. The materials for conducting the exercises, provided here, encourage reflection and discussion.

Rehling, Louise. Journal of Business and Technical Communication (2010). Articles>Education>Collaboration>Technical Writing


The Hidden Relationship Between Project Managers and Technical Writers   (members only)

Want to know the secret to better quality documentation and improved software design? Will Kelly outlines how the key is an effective relationship between project managers and technical writers.

Kelly, William T. TechRepublic (2003). Articles>Collaboration>Project Management>Technical Writing


How Not to Be a Wallflower

For those of us in the field of technical writing who didn't come at this from a computer science background (raise your hand if you’re an English major), we’re often introduced to unfamiliar technologies and terminology at the start of a project. It’s understandable then that we'd want to keep quiet and stay on the sidelines until we better understand what the developers are discussing. I’d like to suggest that doing so will lengthen the ramp-up time, and...

Davidson, Ben. Carolina Communique (2014). Articles>Collaboration>Technical Writing>Agile


How Soon is Now?

One common complaint a lot of technical writers have is that they aren’t included early enough in lifecycle of a project. The downsides are that by the time work hits your desk you don’t have a full picture of who the customer is, why they want whatever it is you are building, and how they want it provided to them. All of which directly impacts the information being created.

McLean, Donna. One Man Writes (2009). Articles>Project Management>Technical Writing>Collaboration


Is Lone Writing Becoming a Team Sport?   (PDF)   (members only)

Larbi discusses the transition—including advantages—that many lone writers face as globalization becomes more prevalent and individual consultants transform into lone writer teams.

Larbi, Nancy E. Intercom (2008). Articles>Writing>Technical Writing>Collaboration


The Issue of Quality in Professional Documentation: How Can Academia Make More of a Difference?   (PDF)   (peer-reviewed)   (members only)

This article recommends strategies academics can use to contribute to an issue of great interest in industry: how best to define, measure, and achieve quality documentation.  These strategies include contextualizing quality definitions, advocating the use of multiple quality measures, conducting research to identify specific heuristics for defining and measuring quality in particular workplace contexts, and partnering with industry to educate upper management about those heuristics and the benefits of promoting technical communicators to the strategic role of organizational “gatekeepers of quality.”

Spilka, Rachel. Technical Communication Quarterly (2000). Articles>Documentation>Collaboration>Technical Writing


Learn from Your Topics and Collaborate

We tech writers can learn from our chunks of content: What makes a topic successful can also make us writers successful! I think there’s a lesson for tech writers here beyond team management: How successful you’ll be in your work as a tech writer depends on how well you define your job’s purpose and communicate it to others.

Weber, Kai. Kai's Tech Writing Blog (2010). Articles>Documentation>Technical Writing>Collaboration


Learning the Fine Art of Reviewing

If you asked me what the most painful part of being a technical writer is, my answer would be: 'Getting reviews on time. Getting good feedback and inputs on your work.' For me technical writing has been very pleasurable because I hardly got any review comments. My morale has therefore been very high. Project managers, developers and others are so busy trying to come up with good software (read trying to fix all the goof-ups and bugs!) that they usually tend to give documentation lesser importance. User manuals, who reads them anyway? We do not have time for it!

Kamath, Gurudutt R. IT People (2003). Articles>Editing>Collaboration>Technical Writing


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


Moving Technical Authors from Institutional Thinking to Network Thinking

In this video clip, Ecademy’s Thomas Power talks about how business leaders will have to switch between “institutional thinking” (closed, selective and controlling) and ”network thinking” (open, random and supportive). There’s a similar challenge for technical communicators - between traditional “closed” user documents and collaborative, conversational, “open” online user assistance.

Pratt, Ellis. Cherryleaf (2009). Articles>Writing>Technical Writing>Collaboration


Now That You've Got a Double Agent, What Do You Do With 'Em?   (PDF)

Having demonstrated the importance of acquiring a double agent for writing projects, we now want to explain the best ways to successfully indoctrinate a double agent. This paper will help you prepare for, orient, train, and become a mentor for a double agent to help make him or her an effective member of your writing team.

Fisher, Judith R., Karen L. Mobley and Michelle M. Wright. STC Proceedings (1994). Articles>Writing>Technical Editing>Collaboration


On Collaboration

Openness is a faster route to better work. There are lots of ways of doing it, but I do think that as much as they pretend pure openness, successful OS projects all have hierarchy.

Mandiberg, Michael. Mandiberg.com (2009). Articles>Collaboration>Technical Writing>Open Source


Open-Source Tech Writing: The Time is Now

We are all going to have to collaborate like never before. Everyone should select at least one area of interest and specialize as best they can. Then we will need to start meeting and sharing information. Immediately. There are several ways to do this, I believe.

Norris, Julie. 2moro Docs (2009). Articles>Collaboration>Technical Writing>Open Source


Organizing Content 22: The Technical Writer as an Outsider: How Ambitious Are You?

After our recent reorg, our tech writing group, now split up, has been wondering about the best way to realign ourselves in the new reporting structure, which has yet to be fully defined. Will we end up at the bottom, relegated into some lonely, forgotten corner of the org chart? Will we be grouped with the finance accountants and the secretaries? Or clumped into some other miscellaneous grouping, like a collection of odd socks?

Johnson, Tom H. I'd Rather Be Writing (2010). Articles>Collaboration>Technical Writing>Workflow


The Proximity Problem for Technical Writers

I’m not convinced that proximity is essential to keeping up with project information. I’m not persuaded that there aren’t equally viable ways to gather the same data and interact, because if nothing else, the Internet has shown us how remotely distributed people can be closely connected with each other. The Internet has pulled us loose from our physical relationships, distancing us from those immediately around us and drawing us closer to others whom we never see or speak with.

Johnson, Tom H. I'd Rather Be Writing (2011). Articles>Workplace>Collaboration>Technical Writing


The Role of the Editor in the Technical Writing Team

Editing today covers far more than printed materials. In this discussion, I am assuming a technical editor may be required to deal with: printed materials (for example, books, pamphlets, quick reference cards); electronic (for example, online documentation, online help, web pages); video scripts; computer-based training materials. I am also assuming that the audience for the material being edited is not comprised of other technical people; or if it is, the editor is not the person responsible for ensuring the technical accuracy of the material.

Hollis Weber, Jean. Technical Editors Eyrie (2002). Articles>Editing>Collaboration>Technical Writing


Sharing Responsibilities in Agile Technical Writing

One challenge a technical writer faces in an agile environment is that the development team splits into a number of sub-teams, each working on a different feature or bundle of features. The sub-teams work in parallel. As a result, all the features simultaneously reach the stage where we can start documenting them, and that’s usually quite close to release date. This can cause major stress for the technical writer and can require overtime work to get everything done in time.

ffeathers (2010). Articles>Collaboration>Agile>Technical Writing


Strategies for Winning Recognition: Building a Visible, Viable, and Valuable Documentation Team   (PDF)

Technical writing teams can improve their standing within their organizations. The purpose of this presentation is to share our experiences at Mirant where we've achieved recognition and respect as a vital internal service to the IT department and, increasingly, to the rest of the company.

Harkness, Holly E. STC Proceedings (2003). Articles>Documentation>Collaboration>Technical Writing


Teaching Technical Writing Through Student Peer-Evaluation   (peer-reviewed)   (members only)

Individual students in two different sections of an undergraduate civil engineering laboratory were tasked with preparing three professional-quality laboratory reports. The teaching assistant and/or instructor used established criteria to grade the first two reports prepared by students in one section. The first two reports prepared by students in the other section were peer evaluated by assigned fellow students within the same laboratory section using identical grading criteria. The peer evaluated section had a higher class average than the teaching assistant/instructor graded section on the fist two reports. The third report prepared by students from both sections was graded by a professional educator/architect without knowledge of a student's class section. The peer evaluation students also had a higher class average on the third report, suggesting that the peer evaluation process may have positively contributed to those students' writing skills.

Jensen, Wayne and Bruce Fischer. Journal of Technical Writing and Communication (2005). Articles>Education>Technical Writing>Collaboration


The Team Approach to Writing Policies and Procedures   (PDF)

Although many companies claim to have working teams within their corporate structure, it may be difficult to use the same approach for writing documentation. With the demands for controlled documentation to meet quality standards, involvement in policy/procedure writing is an important factor in developing a sense of ownership and commitment to maintaining a document control system. A team approach to writing procedures may involve more time, but the results are operations consensus, improved writing skills, and a boost of professional confidence.

Whitmer, Diane L. STC Proceedings (1996). Articles>Documentation>Technical Writing>Collaboration



Follow us on: TwitterFacebookRSSPost about us on: TwitterFacebookDeliciousRSSStumbleUpon