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

JIRA Standard Road Map

27.6.2014 Erweiterte Release Dokumentation 6

JIRA Standard Change Log

27.6.2014 Erweiterte Release Dokumentation 7

JIRA Standard Release Notes

27.6.2014 Erweiterte Release Dokumentation 8

Manuelle Überführung in die Dokumentation

27.6.2014 Erweiterte Release Dokumentation 9

Pro Version ein Space

27.6.2014 Erweiterte Release Dokumentation 10

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

Versionsübersicht per Suche

27.6.2014 Erweiterte Release Dokumentation 12

Flexible Möglichkeit für komplexere Versionsworkflows

27.6.2014 Erweiterte Release Dokumentation 13

catWorkX Version Management Plugin

27.6.2014 Erweiterte Release Dokumentation 14

Anwendung der Atlassian CLI aus Postfunctions

27.6.2014 Erweiterte Release Dokumentation 15

Anwendung der Atlassian CLI aus Postfunctions

27.6.2014 Erweiterte Release Dokumentation 16

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

info@catwokx.de

Tel. +49 40 890 646 - 0