Conference talk in German at the tekom Frühjahrstagung 2015 about a new collaborative approach for developing technical content, presented by K15t Software consultant Martin Häberle on April 24, 2015
Bridging the Gap - B2B Integration for JIRA at Atlassian User Group München 2014
DocOps – Agile Dokumentationserstellung in der Praxis
1. Fachvortrag auf der tekom-Frühjahrstagung
24. April 2015, Darmstadt
!
Martin Häberle, K15t Software GmbH
#tekomf15 FV08
DocOps
Agile Dokumentationserstellung in der Praxis
12. Kulturelle Faktoren
Teamwork
Team ≠ “Toll,
ein anderer
macht’s”
Hüte abgeben
Verantwortung
gemeinsam
übernehmen
Abschmecken
Messen und
bei Bedarf
gegensteuern
13. Prozessbezogene Faktoren
Retrospektive
Ein Blick zurück
hilft beim Blick
nach vorne
Wissensmanagement
Wissenstransfer ist
fester Bestandteil
jedes Prozesses.
Agiles Vorgehen
Klein anfangen,
dann kontinuierlich
verbessern
14. Kaum Zusammenarbeit
Einverständnis fehlt,
dass jeder Inhalte
verbessern darf/soll
Faktor Mensch
Zu wenig Einsicht
Fehlendes Verständnis
für die Arbeit
sämtlicher Beteiligten
Starre Hierarchien
Unflexible
Linien-Organisation statt
interdisziplinärer Teams
18. Auswirkungen von DocOps
Kommunikativer
Abstimmung
zwischen den
Beteiligten wird
ritualisiert.
Sichtbarer
Informations-
Erstellung rückt
in den Fokus der
Beteiligten.
Qualitätsbewusster
Mehr Feedback
und Transparenz
reduziert die
Fehlerzahl.
19. Auswirkungen auf die Technischen Inhalte
Vollständiger
Jeder kann Inhalte
erweitern oder
Änderungen
anregen.
Aktueller
Jeder kann veraltete
Inhalte aktualisieren
und neue Sachverhalte
sofort ergänzen.
Nützlicher
Jeder kann seinen
Blickwinkel und sein
Expertenwissen
einbringen
20. Kunden-Feedback
einarbeiten
Inhalte kuratieren
= sammeln + veredeln
Content Strategy
(weiter-)entwickeln
Autoren unterstützen
und beraten/schulen
Content-Plattform und
Prozesse verbessern
DocOps
Auswirkungen auf die Rolle des Techn. Redakteurs
23. 300 Beteiligte
Support Knowledge Base und Produktdokumentation wurden
parallel mit hohem Aufwand, aber ohne Synergieeffekte gepflegt.
24.000 Dokumente
Informationsmanagement bei CA
19 Sprachen
24. Verbesserte Zusammenarbeit gemäß DocOps
Ziele von CA
Schneller Inhalte bereitstellen durch agile Prozesse
Qualität und Nutzwert der technischen Inhalte erhöhen
Zentrale Plattform für alle technischen Inhalte
25. Übersetzungsprozess
Die Wahl fiel auf die Kollaborationsplattform Atlassian Confluence
ergänzt durch die Scroll Add-ons.
AnalyticsSprachprüfungWeb-Zugriff
DocOps-Plattform bei CA
33. Kunde
1. Anfrage/Problem/Change Request geht ein
Anfrage / Change Request
erstellt
Support
wird geprüft von
in Zendesk oder JIRA
Individualproblem
in Zendesk
produktrelevant
in JIRA
34. Support + Entwickler
2. Klärung der Anfrage
Individualproblem
wird gelöst von
Kunde
informiert
produktrelevant
KB-Artikel
in Confluence
erstellen
Link an Kunden senden / Anfrage abschließen
35. 3. Wissensmanagement in der Knowledge Base
KB-Artikel
in ConfluenceSupport + Entwickler
Inhalte werden kontinuierlich verbessert
Tech Writer
sichtet und prüft
36. 4. Relevanz und Priorität für Produktdokumentation klären
KB-Artikel
in Confluence
Tech Writerfalls relevant für Iteration einplanen
Doku-Aufgabe
in JIRA
Support
38. besprechen
Aufgaben
in JIRA
Hilfe + KB
in Confluence
Produkt
neueste Version
Prozesse
im Unternehmen
bewerten
6. Retrospektive zum Release
Tech WriterSupportEntwickler Product Owner
Verbesserungsmaßnahmen
als Aufgabe / Change Request in JIRA
40. Erfolgsfaktoren für DocOps
Chefetage einbinden
DocOps funktioniert nur mit Rückhalt des Managements
Agil agieren
Inhalte, Prozesse und Werkzeuge kontinuierlich verbessern
Regelmäßige Abstimmung
Retrospektiven, Stand-ups etc. zur Gewohnheit werden lassen
Teamwork
Spaß an der Arbeit und Erfolgserlebnisse schweißen zusammen
41. Erfolgsfaktoren für DocOps
Mehrfachrollen vermeiden
Gerade bei Kleinunternehmen sind Ressourcen begrenzt
Alte Prozesse/Systeme schnell ablösen
DocOps setzt Wandel in den Köpfen und eine Plattform voraus
Andere Prioritäten setzen
Etwa die Zufriedenheit von Kunden und Mitarbeitern
Feedback ermöglichen
um Nutzen zu erhöhen und Erfolge zu messen