Blog

Eine Tasse auf Reisen #3 - die Auflösung

Vor welchem Gebäude wurde die parson-Tasse fotografiert, haben wir Anfang Juni gefragt. Die Frage war knifflig. Trotzdem kamen die meisten auf die richtige Antwort: vor dem Himmelstempel in Peking. mehr ...

Gewinnspiel: Eine Tasse auf Reisen #3

Die parson-Tasse hat wieder fleißig Meilen gesammelt! Wohin es den "Abenteurer" diesmal verschlagen hat, erkennen Sie vielleicht nicht auf den ersten Blick, mithilfe unserer Tipps aber ganz bestimmt. mehr ...

B2Run 2017 in Hamburg: Neue T-Shirts und ein Fingerklopfer

Diesmal wurde unsere Kollegin Esther zwar nicht von einem Dackel überholt, dafür wurde ihr auf die Finger geklopft. mehr ...

Technische Dokumentation zur SEO? Ein Gastbeitrag von Dr. Markus Nickl

Suchmaschinenoptimierung ist ein breites Feld: Man hat den Eindruck, dass es fast an jeder Ecke eine SEO-Agentur gibt. Obwohl hier Budgetquellen für die Technische Dokumentation ungenutzt bleiben, nimmt unsere Branche Suchmaschinenoptimierung aber bisher kaum als Thema wahr. Warum ist das so? mehr ...

Agile Dokumentation – funktioniert das?

Das Stichwort agil ist in der Softwareentwicklung mindestens so beliebt wie DITA in der Technischen Dokumentation. Kein Wunder: Agil und DITA konzentrieren sich auf Modularisierung und die Anforderungen der Nutzer. mehr ...

Agile Dokumentation – funktioniert das?

Das Stichwort agil ist in der Softwareentwicklung mindestens so beliebt wie DITA in der Technischen Dokumentation. Kein Wunder: Agil und DITA konzentrieren sich auf Modularisierung und die Anforderungen der Nutzer.

Scrum-Projekt. Quelle: parson AGScrum-Projekt. Quelle: parson AGMarion Knebels Artikel zu agiler Dokumentation wurde in der Zeitschrift Dokuworld, Ausgabe 1-2017, veröffentlicht. Der Artikel beleuchtet, wie agiles Dokumentieren in der Praxis funktioniert. Sie finden den Artikel hier als PDF und auf unserer Website.

Kommentare   

# Henning S. 2017-05-07 15:04
Richtig praktiziert kann agiles Dokumentieren sehr gut funktionieren und auch die Ergebnisse sind mMn besser als in anderen Sw-Entwicklungsprozessen. Bleibt die Frage nach den Tools: DITA oder vielleicht doch lieber Confluence oder Markdown mit einem statischen Site-Generator?
Antworten
# Marion Knebel 2017-05-08 10:42
Ich stimme vollkommen zu, dass das Dokumentieren in agilen Umgebunen sehr gut funktionieren kann. Die Frage nach den Tools sehe ich aber eher losgelöst davon. Pauschal gibt es da m.E. keine richtige Antwort. Die Auswahl des Tools muss sich aus den individuellen Anforderungen ergeben. Wenn Sie z.B. viel Übersetzungsbedarf haben und Sie viele Varianten benötigen, werden Sie mit Confluence oder Markdown nicht weit kommen und benötigen am Ende vielleicht sogar ein Redaktionssystem. Wenn Sie andererseits entwicklernahe Dokumentation haben und die Entwickler selbst an der Dokumentation mitarbeiten sollen, kann man auch mit Markdown schöne Sachen machen (oder aber Markdown-Content in DITA integrieren). Möglichkeiten gibt es am Ende viele und alle (na ja, die meisten :) habe ihre Berechtigung. Für welches Tool haben Sie sich entschieden und warum?
Antworten
# Henning S. 2017-05-08 18:12
Die Frage könnte auch lauten: Eignen sich manche Tools besser als andere für das agile Dokumentieren? Tendenziell sehe ich einige Vorteile bei schlanken Tools (Wiki, Markdown). Richtig ist aber natürlich auch: Die Deliverables (z. B. mehrere Varianten, unterschiedliche Ausgabemedien, mehrere Sprachen) können es erfordern, andere Tools zu verwenden. Es kommt also auf den Einzelfall an. Framemaker funktioniert für mich ganz gut, agil ebenso wie vorher bereits klassisch.
Antworten

Kommentar schreiben


  • facebook
  • linkedin
  • xing