Was haben Sex, Tamagotchis und der Tod mit Dokumentation zu tun?

Als ich über Weihnachten verschiedene Blogbeiträge zu Agiler Dokumentation gelesen habe, sind mir drei Zitate besonders in Erinnerung geblieben, die mit „Documentation is like…“ anfingen. Viele sagen, dass Dokumentation langweilig und nervig ist, aber in diesen Zitaten und in diesem Beitrag geht es um Sex, Tamagotchis und den Tod.

„Was haben Sex, Tamagotchis und der Tod mit Dokumentation zu tun?“ weiterlesen

Was motiviert Mitarbeiter zu dokumentieren?

Als ich am Wochenende den t3n-Artikel „Die Job-Transformer“ (Ausgabe 53) gelesen habe, stach mir folgendes Zitat von Bosch-Manager Rendenbach ins Auge: „Die Helden der Zukunft sind die, die nicht nur Fachwissen haben, sondern es auch weitergeben.“. Aber was motiviert Mitarbeiter dazu, ihr Fachwissen zu teilen? Sind es wirklich die Likes, die andere geben, wenn sie den Artikel oder das Lernvideo gut finden? Ich bezweifele das. „Was motiviert Mitarbeiter zu dokumentieren?“ weiterlesen

Das belächelte Glossar lacht zurück

Es klingt schon ziemlich altbacken, wenn am Anfang eines Projektes der Vorschlag zu einem gemeinsamen Glossars im Raum steht, aber gerade in einem agilen Umfeld ist ein Glossar durchaus sinnvoll. Hier wird mehr Wert auf schlanke Kommunikation, als auf umfangreichen Definitionen gelegt. Durch ein gemeinsames Verständnis kommt man schneller zum Ziel, ohne über Äpfel und Birnen zu diskutieren. „Das belächelte Glossar lacht zurück“ weiterlesen

Unterschiedliche Sichten auf die Produktdokumentation ermöglichen

Spätestens wenn man sich für Confluence (oder ein anderes Wiki) als Tool für die Produktdokumentation entschieden hat, stellt sich die Frage, wie man die angelegten Seiten strukturieren soll. Dafür gibt es bei Anwendungen mit hohem User-Interface-Anteil zwei offensichtliche Möglichkeiten: entweder man gliedert nach Feature-Schnitt oder nach den einzelnen Seiten in der Anwendung. „Unterschiedliche Sichten auf die Produktdokumentation ermöglichen“ weiterlesen