Blog

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 ...

Flipped Classroom: Make Your Training More Efficient

Paying attention to students with different skill levels requires much time during onsite training. Students with more knowledge can get bored easily. Vice versa, students with less knowledge may get overwhelmed. more ...

"Write the Docs" Impressions

On July 19 and 20, I joined the Berlin Unconference “Write the Docs”. I had not attended an event with open-space sessions and lighting talks before and did not know what to expect.

Turned out I was nearly the only one from Berlin. Also, few technical writers attended. Hardly anyone spoke German as most participants were from other European countries. All were in the software development business, among them many software engineers who specialize in writing software developer documentation. The discussions focussed on technical writing issues, but also on topics like “how to build a community”, “human testing of documentation”, or “smart documentation”. I found it exciting to see how differently tech writers and software engineers approach these topics. Sometimes software engineers try to reinvent the wheel because they are not familiar with the technical writing paradigms. But they make up for it: They are target-oriented and think outside the box.

Everyone was surprised when I told them about the largest European conference on technical documentation, the annual tekom conference.  During a lighting talk I spontaneously invited all of them to attend that conference and meet the technical writing community. In fact, I wish there was more exchange between tech writers and software engineers about developer documentation, API documentation, and documentation systems. Both sides could learn a great deal from each other.

I would love to attend a similar event again. But next time, I’ll take some tech writers along.

More information:

Add comment


  • facebook
  • linkedin
  • xing