Applying Web 2.0 Technologies to Technical Documentation

This article is based on my presentation at the Institute of Scientific and Technical Communicators' annual conference in October, 2006. Every now and then, there is a change in the value of what technical authors deliver. These are moments when organisations pay attention to technical documentation. This is because they recognise that these changes mean they can create something that will be of real value to the business and to their customers. In recent years, there have been three "waves of interestingness". The first wave was the introduction of Windows Help (WinHelp). The second major wave was the introduction of the Internet and intranets. This was a time when organisations looked at how they could transfer large amounts of information from paper to online. They were faced with issues such as how users could access and understand all this information easily - issues that technical communicators deal with on a day-to-day basis. I believe we're just about to approach the new wave, which we have called "Tech Writing 2.0".

Pratt, Ellis. Cherryleaf (2006). Articles>Web Design>Documentation>Technical Writing

The Marketing of Technical Authors

In May 2004, I did a presentation to the London group of the Institute of Scientific and Technical Communicators on the future for technical authors. This article expands one of the topics discussed - how to promote and market technical authors.

Pratt, Ellis. Cherryleaf (2004). Careers>Writing>Marketing>Technical Writing

Reducing Translation and Localisation Costs

These days, staff in localisation departments spend their time essentially on project management, translation and quality assurance. However, by using one of the emerging systems that integrate content creation, localisation and content management into an efficient system, many of these activities can be automated or avoided all together. We are now seeing the emergence of technical content control systems that can be used to improve the turn-around time, translation costs and the quality of the translations themselves. In recent projects, where these systems have been implemented, organisations have seen substantial savings in localisation costs, with word count reductions and translation costs of around 30%.

Pratt, Ellis. Cherryleaf (2004). Articles>Language>Localization

The Six Biggest Mistakes Project Managers Make with Documentation and How to Avoid Them

Professional business writers, such as technical authors, typically break a document down into small, discrete units of information, organised around a skeleton of topic headings. If you use this 'component' or 'modular' approach, you can plan and structure the document using the heading 'labels' that describe each section.

Pratt, Ellis. Cherryleaf (2007). Articles>Documentation>Planning>Project Management

A Solution to Writing Winning Sales Proposals and Other Sales Documents

This article explains how we built a solution to producing sales proposals and other sales literature for our own company using an affordable content management solution.

Pratt, Ellis. Cherryleaf (2003). Articles>Business Communication>Single Sourcing>Documentation

Tech Writing 2.0: Special Report on New Trends in User Documentation

This report outlines the developments in what many are calling "Web 2.0" and the impact that these developments may have on technical and user documentation. We've called these trends "Tech Writing 2.0". Tech Writing 2.0 promises a new means of communication that business can use to promote and support their products and services. This means that the nature of technical communication will change.

Pratt, Ellis. Cherryleaf (2006). Articles>Writing>Technical Writing>User Centered Design

Confessions of a Technical Author: What Can Technical Communicators Learn from David Ogilvy?

David Ogilvy was an advertising genius who distilled his successful concepts and techniques into a bestselling book I've just finished reading, called "Confessions of an Advertising Man". I wanted to read his book, because I often find it useful to look at other professions and ask whether their ideas could be applied to the world of technical authoring.

Pratt, Ellis. Cherryleaf (2008). Articles>TC>Writing>Technical Writing

Zen and the Art of Help Files

I would argue that 'Presentation Zen' contains ideas that are also relevant to technical communication.

Pratt, Ellis. Cherryleaf (2008). Articles>Documentation>Online>Help

The Return on Investment of Documentation and Support

The benefits of user documentation (reduced support calls, increase in the perceived value of the product, happier customers, better customer retention, increase product usage etc) can be identified, but it can be hard to measure them and accurately quantify the Return on Investment.

Pratt, Ellis. Cherryleaf (2008). Articles>Documentation>Management