Blog

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

In which country was the parson mug photographed, we asked at the beginning of December. more ...

RDF is not XML – RDF serialization and iiRDS metadata

The world of technical writing loves XML. Its document type definitions are the foundation of structured authoring. XML and the underlying schemas structure the content of our information products. The benefits are twofold. Content is consistently structured and easy to read. Authors have an easier time writing the content. The structure provides guidelines for authoring. more ...

The parson mug prize draw #5

It is winter in Hamburg and Christmas is right around the corner. Meanwhile, the parson mug gets to enjoy the sun! more ...

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

Can Wikis be Used for Technical Documentation?

The results of Britta Görs' interesting survey are out. Her central question was: Is a wiki suited for technical documentation?

The answer is ambiguous. Two thirds of the 70 technical writers, who participated in the survey, stated that they primarily use a wiki for knowledge management. Only 12 percent use the wiki as a content management system for creating external documentation, but 22 percent create internal documentation in a wiki. Almost wo thirds disagreed with the statement that "a wiki is never finished, so it is not suited for technical documentation".

Almost all (90 %) agreed: A wiki is the ideal tool for collaborating and exchanging information. But when it came to the following statement: "The customer can comment on the documentation in the wiki", only 24 percent agreed and, interestingly enough, almost the same number of participants (33 percent) disagreed.

Check out the results of the survey (in German) here:

Survey analysis part 1: http://www.brittagoers.de/umfrageauswertung_wiki/

Survey analysis part 2: http://www.brittagoers.de/umfrageauswertung-ein-wiki-in-der-technischen-dokumentation-geht-das-teil-2/

For more information about wikis and how they can be used effectively, refer to our knowledge base:

 

Add comment


  • facebook
  • linkedin
  • xing