Blog

How to become a technical writer – Confessions of a former translator

A former translator, I worked the first seven years of my professional life in the translation industry, in various positions. While I learned a lot from this experience, it also left me, as a writer, frustrated. Translators are chained to their source text and writing the words of others in another language, usually focusing on what their clients want. more ...

tekom impressions part 2: API documentation and the VUKA world

Daniela Herbold and Ulrike Parson write about better API documentation and solutions for innovative human resources management. more ...

Impressions from tcworld 2017

Part 1: Improvisation, fluff hunt, and videos for technical documentation. more ...

My first time at tekom

I got back from Stuttgart last night and it is safe to say that after three days of action-packed presentations, writing an article is not in the realm of possibilities right now as I try to connect one synapse with another. more ...

The parson mug prize draw #4. Congratulations to the winners

In which city was the parson mug photographed, we asked at the beginning of September. more ...

Say it with pictures

What comes to your mind when you see a picture of an umbrella? I think of a typical rainy day in Hamburg. In India, this image could trigger a completely different response  bad memories of the colonial era.

Fotolia Regenschirm© Janis Abolins - Fotolia.com

Images in technical documentation show our readers which button to click, which pane to select, and which cable goes in which socket. With a screenshot or illustration, we can often explain more than with a long, descriptive text.

When we use images in documentation, we have to consider our target audience. Could our readers interpret an image differently, like in the example above? Could the image cause an unwanted reaction?

Images are important for international audiences. It's  not always given that the language of the documentation is also the native language of the reader. Images increase comprehensibility, warn against danger, or help avoid mistakes.

In the new knowledge base article "Visualize information - say it wit pictures", Katrin Mehl and Elisabeth Fischer show how we can create a good and meaningful image, explain the different depiction types, and point out possible obstacles.

 

Add comment


  • facebook
  • linkedin
  • xing