Ein
Im
puls
vort
rag Integration von JIRA und Confluence
für eine erweitere Release
Dokumentation
o Dr. Wolfgang Tank
Hamburg, 27. Juni 2014
Agenda
• Zweck einer Release Dokumentation
• Statusquo von Release Management und Dokumentation mit
Atlassian Tools
• Lösungsansätze zur Erweiterung und vorhandene Building
Blocks
27.6.2014 Erweiterte Release Dokumentation 2
Zweck der Release Dokumentation
• Nachproduktion oder Rückverfolgung von speziellen Releases
für einzelne Kunden oder Plattformen
• Wiederherstellung vereinfachen
• Ausbildung und Vorbereitung der Mitarbeiter, die das System
nutzen
• Ausbildung und Vorbereitung der Mitarbeiter, die das System
pflegen
27.6.2014 Erweiterte Release Dokumentation 3
Planungsinformationen zu Versionen in JIRA
Nur rudimentäre Plandaten in JIRA möglch
27.6.2014 Erweiterte Release Dokumentation 4
Unterstützung des Lebenszyklus von Versionen
Nur geringe prozedurale Unterstützung des Lebenszyklus von Versionen
27.6.2014 Erweiterte Release Dokumentation 5
Lösungsansätze
• Erweitertes Versionsmanagement über Issues
• Copy Version Space via Postfunction
• Switch Permission for released Versions
• Transfer Release Notes via Postfunction with create page
from Template
• Auto-Modify von Wiki-Seiten in Bezug auf Anpassung von
Macro-Konfigurationen
27.6.2014 Erweiterte Release Dokumentation 11
Vorführszenario
• Erzeuge neue Version als Issue
• Erzeuge wahlweise New Feature / Bugs und setze für diese
die gerade erzeugte Version als Fix Version
• Starte die Bearbeitung und erzeuge automatisch eine
assoziierte Dokumentationsseite
• Setze die Version als Label für die Seite
• Clone den Versions-Space beispielhaft mit einem Code-
Freeze
• Modifiziere die Rechte an dem Versionsspace mit einem
Release-Übergang
27.6.2014 Erweiterte Release Dokumentation 17
Fazit / Ausblick
• Standard Version Management in JIRA ist ein vergleichsweise
„schwaches“ Feature
• Nutze die Stärke und Flexibilität von JIRA
• Versionen als Issues
• Ausführen der JIRA-Buildin Versionsoperationen per Postfunctions
• Semi-Automatisierte Erzeugung von Versionsdokumentation
in Verbindung mit Workflow-Übergängen
• Autogenerierung von Index-Seiten mit dynamischem Content
aus JIRA bzw. über JIRA adressierbarer Seiten
• Integration von K15T´s Scroll Versions anstelle von
Bereichskopien
27.6.2014 Erweiterte Release Dokumentation 18
The performance of a system depends more on how
ist parts interact than on how they act
independently of each other.
Russell L. Ackhoff, Ackhoff´s Best
Kontakt
catWorkX GmbH
Schellerdamm 16
21079 Hamburg
http://www.catworkx.de
Tel. +49 40 890 646 - 0