Doctor Strange – Insights into Technical Documentation

What is the connection between a movie based on a comic and technical documentation? You might think there is none. But on Saturday I was delightfully surprised to find that Dr. Strange is an advocator of good documentation. Last Saturday was marvel-lous.

Spoilergefahr

WARNING: DANGER OF SPOILERS!
This blog article may contain spoilers.
Spoilers may ruin your movie experience and potentially result in physical retaliation against the author of this article.

Just a joke. This article will of course not contain any major spoilers, that is, we will not disclose any details that are relevant to the story or ending of the movie. The good guy wins, the bad guy loses, that much is for sure anyway.

I digress. Back to technical documentation. In the movie, there is a secret book in the library that describes some rituals with the potential to shatter the world, including some tempering with time and other dimensions. You know, stuff that sorcerers do on an average day. The hero starts reading and immediately goes into action – without reading the instructions until the end, of course. Just before something really bad is about to happen, he is stopped by his tutors. They warn him about the dangers ahead and ask if he hasn’t read the warnings. Doctor Strange answers that he didn’t get so far and why are the warnings placed at the end anyway? In other words, had the author consulted with a technical writer, the warnings would have been placed where they belong: before the steps that potentially wreak havoc.

Thank you Doctor Strange for the entertaining introduction into well-structured procedures.

On a side note: The villain tempered with the rituals as well and did not read the warnings either. However, who knows how the story would have ended if he had ...

Image source:
Gefahrzeichen © Reeel. Fotolia.com

Blog

tcworld 2018: What's New with iiRDS?

iiRDS was one of the central topics at the tcworld conference 2018: at the new iiRDS Café, in lectures, showcases, and tutorials. There was also a discussion on Twitter, among other things about the name, which is so difficult to pronounce. more ...

tcworld 2018 part 3: Creative online videos for technical documentation

Clear the stage! At the beginning of his workshop "Creating thrilling online videos", Stephan Schneider showed two pictures. more ...

tcworld 2018 part 2: Virtual and actual highlights

The sun is shining brightly as I arrive for my first tekom. Inside, the conference is already in full swing. Two days of presentations, workshops, fair impressions and conversations await. more ...

tcworld 2018 part 1: Legal Requirements vs Readability

At this year's tcworld conference, there were a lot of discussions about standards and regulations for technical documentation. Experts such as Jens-Uwe Heuer-James and Torsten Gruchmann came together for a panel discussion where the following was repeatedly said: "We need an IEC 82079-1!" more ...

Working in self-organizing teams. Or: how we get rid of management

Today's world is VUCA : volatile, uncertain, complex, and ambiguous. Companies are facing complex challenges such as Industry 4.0 and the Internet of Things. Those who do not respond fast, may be driven out of the market. more ...
  • linkedin
  • xing