Using the Wheel – a story

This is an adapted version of a story from Selling the Wheel, by Jeff Cox: Once upon a time, long ago, a resourceful fellow named Max came up with a brilliant idea and invented the Wheel. He said to his wife, ‘you know what, the Wheel is going to make us lots of money’. His… Read more »

Unifying conversation and instruction in business communication

One of the challenges organisations face is how to create a system that unifies all the different ways its staff communicate information. That’s because conversation (written and oral) can be very different from instructional information. For example, conversations are often reflective, insightful and repetitive, whereas instructions are typically results-driven, concise and commanding. We can see… Read more »

The User Manual 2.$

Here is an interesting interview between Robert Scoble and Aaron Fulkerson of Midtouch on how MindTouch’s technical communication software is changing how people work together at big companies. “We started seeing more and more of our customers—Intuit and Microsoft, Intel and Autodesk and Mozilla – launching these documentation communities where they have a body of… Read more »

Building intelligence into business documents

Often business documents, such as sales proposals and annual reports, are a joint effort between various people and departments. It involves collaborative writing and incorporating existing content. For printable documents, this collaboration can make it really difficult to maintain a consistent level of quality, writing style and “look and feel”. For Technical Communicators, there’s an… Read more »

Why do Technical Authors only use two of the three qualities of good design?

Why do Technical Authors only use two of the three qualities of good design? Vitruvius, the Roman architect, claimed a structure must exhibit the three qualities of firmitas, utilitas and venustas: it must be solid, useful and beautiful. Paul Mijksenaar, a modern day Information Designer, turned these qualities into a practical three-point formula: Reliability, Utility and… Read more »