The future of technical documentation is more about psychology than technology

In the quest to offer better forms of user assistance, most experts in the technical communications profession propose technological solutions: using XML, intelligent and adaptive content etc. to present essentially the same type of guidance as has been provided for the past 20 years.

We believe there has been a change in the relationship between people and technology, and there needs to be a corresponding change in the relationship between people and the user documentation.

In the past, a lot of technology was unfamiliar, idiosyncratic, expensive and complex; users often became anxious when they used a product. As technology has become part of everyone’s daily lives (particularly Web and mobile applications), people’s relationship with a great deal of technology has changed.

As a consequence, for some types of products and for some types of documents, the traditional approach for technical writing is no longer appropriate.

This means Technical Authors need a better understanding of this relationship – the psychology of users – and understand how they can relate and communicate to users in context.

We are not suggesting that the traditional approach to technical writing should go away completely. We’re also not arguing against technology such as XML and DITA – these are vehicles for delivering content. We’ll still be writing user documentation for scientific equipment and financial systems in the traditional way, as these types of products fit the traditional model. However, even the documentation for these types of products can benefit from the inclusion of some psychological techniques.

Web sites such as voiceandtone.com indicate some of the changes that we are likely to see in technical documentation, but we disagree with some of the approaches suggested on this site for some types of documents, and we feel this site only scratches the surface.

There is evidence from randomised control trials that these new approaches work, although we recommend you carry out your own testing to double check it works for your users.

So having come to be belief that Technical Authors need to incorporate some new techniques into their documentation, what should happen next? One approach is to engage Cherryleaf to provide advice or write documents. In addition, you’re able to discover these techniques through our new advanced technical writing training course. However, the starting point is to recognize the change in the relationship between users and many products, and to recognize the need to change the approach to technical writing so that it’s appropriate to the situation.

The question is, do you agree?

4 Comments

Raj

What kind of psychology are you talking about? The psychology of first-time uses or advanced users? The psychology of developers or testers? The psychology of end users including the management? The psychology of youngsters and senior citizens?

ellis

The different types of users, the different contexts in which they interact with the product, and how to communicate with them in the best way.

Laura

What an odd blog post! “The question is, do you agree?” … but you haven’t given enough to agree or disagree with. Are you wondering whether I agree that users’ relationships with some products have changed over time, or that psychology is relevant to technical writing? I do, but it’s hardly worth a blog post for such generalities. It seems as if I need to take your course or hire you to discover any details of your vaunted “new approaches”.

Or are you just soliciting my business? If so, you’ll want to copy edit your posts. 😉

ellis

We often end a post asking people for their thoughts. This time we asked if people agree or not, and it seems to have led to more comments. As to the question, it’s do you agree that the future of technical documentation is more about psychology than technology?

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.