Benefits and Challenges for Technical Writers in the Agile World

29. Mai 2020

Bei den IXIAtalks am 11. Juni 2020 spricht Marion Knebel  über die Herausforderungen der Arbeit von Technischen Redakteuren in der agilen Softwareentwicklung. 

IXIAtalks am 11. Juni 2020, 11:00 AM – 12:00 PM (EDT)

 

Beschreibung

Agile was a buzzword 10 years ago. Nowadays, most software engineering departments seem to think that they follow agile principles. But often, they just make use of some tools that are provided by methodologies like Scrum, but they do not live up to agile principles. Being a technical writer in an agile setup can be heaven or hell: Either you have fantastic teammates, are deeply involved in the work and get input more easily than ever before. Or you become extremely frustrated because you are not really part of the game. No one gives you any input, because who needs a written specification, and you never get the documentation ready on time.  

Whichever is true for you or if you are just curious about what agile is about and whether you can benefit from agile principles: this presentation has something to offer. You will be provided with practical ideas on how to organize your work and your team in an agile world, how to avoid common pitfalls, and when it might be time to look beyond your technical writing mindset. 

Kommentare

Implizit klingt es in dem Artikel ja an, ich würde es noch pointierter ausdrücken: Wer in einem agilen Umfeld dokumentiert, ist gut beraten, über das Rightsizing der Dokumentation nachzudenken, also über Umfang, Tiefe, Auslieferungsformate und -wege. Allzu oft wird „die Dokumentation“ gleichgesetzt mit schwerwichtigem Handbuch plus Onlinehilfe, tatsächlich sind dies aber Konzepte aus der voragilen Zeit, die passen können oder auch nicht. Dazu passt, dass die ISO-Norm 26515 „Developing information for users in an agile environment“ in der Ausgabe von 2018 auf den Begriff "documentation" gleich ganz verzichtet und konsequent von „information for users“ spricht. Und Informationen können vielfältige Formen annehmen...

Ja, das stimmt. Auch technische Produkte, nicht zuletzt Software, werden immer modularer. Das bedeutet, wir brauchen auch eine modulare Informationsarchitektur, die zielgerichtete Auslieferung, continuous build und feature-driven documentation unterstützt. Für mich gehört dazu auch, dass "information for users" nicht nur Handbuch oder Hilfe ist, sondern auch UI-Texte, Fehlermeldungen, API-Doku, Datenblätter, Support-Informationen - also alles was verschiedene Anwender unterstützt.

Neuen Kommentar hinzufügen

Ihre E-Mail-Adresse wird nicht veröffentlicht.

Das könnte Sie auch interessieren

Standards sind die Guten! Technische Standards für die Umstellung auf intelligente Informationen

von Uta Lange am 26. November 2020

Intelligente Informationen gibt es mittlerweile in der Dokumentation, im Marketing und im Service. Sie ergänzen smarte Applikationen, Dienstleistungen, Komponenten und Anlagen. Und genau wie Services und Komponenten müssen in Industrie 4.0 auch intelligente Informationen vernetzt sein. Allerdings ist der Umstieg auf intelligente Informationen aufwändig. mehr...

Die Beschwörung der Wortschlange – Terminologiearbeit und Sprachprüfung mit Python

von am 24. November 2020

Mussten Sie jemals manuell Termini aus Hunderten von Dokumenten extrahieren? Haben Sie sich schon mal durch Dutzende von Topics gewühlt, um zu prüfen, ob die Autoren die Schreibregeln einhalten? Und dachten Sie dabei, dass diese Aufgaben auch gut von einer Software statt von Ihnen erledigt werden könnten – nur ist diese Software viel zu teuer? mehr...