Autor: Stefan Voigt

Workshop zu Dokumentationsmustern

Innerhalb des Forschungsprojektes sprintDoc entstehen eine Dokumentationsmethode für agile Softwareprojekte und ein Prototyp für ein unterstützendes Werkzeug. Im Rahmen der Methode haben wir uns Gedanken über mögliche „Dokumentationsmuster“ gemacht. Dabei stellt sich die Frage, welche Informationen in dokumentiert werden sollten, wie die Informationen strukturiert sind und wie diese untereinander verknüpft sein sollten.

Gemeinsam mit unseren Pilotanwendern haben wir erste Dokumentationsmuster entwickelt. Unterschiedliche Rahmenbedingungen, Produkte oder Arbeitsweisen führen zu verschiedenen Anforderungen an die Dokumentation. Daher wollen wir gemeinsam mit Unternehmensvertretern Dokumentationsmuster für konkrete Anwendungsfälle erarbeiten. Aktuell planen wir im September 2016 einen entsprechenden Workshop „Dokumentationsmuster in agilen Softwareprojekten“.

Der Workshop findet am Montag, 26. September von 10:00 bis 15:00 Uhr bei der Fa. CosmoCode in Berlin statt. Nähere Informationen (inkl. Agenda) zum kostenfreien Workshop können unserem Workshopkonzept entnommen werden. Interessierte Praktiker aus agil softwareentwickelnden Unternehmen melden sich bitte per Mail bei Herrn Voigt von der Otto-von-Guericke-Universität.

Flexible Dokumentationsstrukturen mit dem struct-Plugin

Einige strukturierte Wikis – wie auch das im Projekt verwendete DokuWiki – ermöglichen die Integration strukturierter Daten. Dabei gibt es sehr unterschiedliche Anwendungsmöglichkeiten, denn mit der Verknüpfung von Wikiseiten und den darin enthaltenen Daten lassen sich verschiedenste Dokumentationsstrukturen realisieren. So lassen sich beispielsweise Projektdokumentationen mit den zugehörigen Meetings oder auch den wichtigsten Anforderungen verknüpfen.

Flexible Dokumentationsstrukturen mit dem struct-Plugin weiterlesen

Definition von Agilität in der Softwareentwicklung

Die Wissenschaftstage des Fraunhofer IFF in Magdeburg sind ein alljährliches Forum für Expertinnen und Experten aus Wissenschaft, Wirtschaft und Politik. Das Erfolgsrezept der mehrtägigen Konferenz ist eine stets gelungene Mischung aus aktuellen Inhalten, exzellenten Referentinnen und Referenten und hochinteressiertem Fachpublikum. In diesem Kontext findet der „9. Internationale Doktorandenworkshop Logistik“ direkt vor dem Beginn der „Magdeburger Logistiktagung“ statt.

Herr Voigt von der Otto-von-Guericke-Universität wird sich innerhalb des Doktorandenworkshops mit der Definition des Begriffes „Agilität“ in der Softwareentwicklung auseinander setzen und dabei das Projekt sprintDoc vorstellen. Sein Vortrag steht unter dem Titel „Scientific Approximation of “Agile Software Development““. Der Doktorandenworkshop findet am 22. Juni 2016 von 9:00-12:30 Uhr im VDTC des Fraunhofer IFF in Magdeburg statt.

Prototyp des MagicMatcher wird auf Tagung vorgestellt

Das erste wissenschaftliche Paper aus dem sprintDoc-Projekt wurde für die CISTI’2016 – 11th Iberian Conference on Information Systems and Technologies angenommen. Hier stellen wir auf einer international renommierten Tagung unser Werkzeugkonzept und den ersten Prototypen des MagicMatchers vor.

Der MagicMatcher verbindet vier Systeme aus dem agilen Softwareentwicklungsprozess:

  • Bug-/Issue-Tracker
  • Code-Verwaltung (VCS)
  • Entwicklungsumgebung (IDE)
  • Wiki

In der oberen Grafik wird der zentrale Use-Case innerhalb der agilen Softwareentwicklung anhand der folgenden Nummern verdeutlicht:

  1. Spezifikation und Diskussion von Design- /Umsetzungsvarianten
    im Ticket-System über Kommentare
  2. Umsetzung erfolgt in der Entwicklungsumgebung unter „Mitnahme“ der Ticket-ID
  3. Commit an Code-Verwaltung unter Übergabe der Ticket-ID
  4. Über das verlinkte Ticket setzt der Entwickler den Status des Tickets neu
  5. Über das Ticket-System erfolgt eine automatischer Verlinkung in das Wiki in den korrekten Bereich der Dokumentation

Im Wiki können über den MagicMatcher kontextflexibel passende Seiten, Code-Dateien oder Tickets angezeigt werden.

Der Beitrag wird anschließend in der IEEE Xplore Digital Library veröffentlicht und ist unter folgendem Link abrufbar: sprintDoc: Concept for an agile documentation tool.

Dokumentation in agilen Softwareprojekten

Im November/Dezember 2015 haben wir eine Online-Befragung zur „Dokumentation in agilen Softwareentwicklungsprojekten“ durchgeführt. An dieser Befragung haben 104 Personen aus hauptsächlich mittelständischen Softwareunternehmen teilgenommen.

Bei der offenen Eingabe des durchschnittlichen Anteils der aufgewendeten Arbeitszeit für die Dokumentation lag der Mittelwert bei 16%. Dem gegenüber steht ein durchschnittlicher Informationssuchanteil von 25% der Arbeitszeit. Verglichen mit unserer Tätigkeitsanalyse erscheinen diese Werte recht hoch (4% Arbeitszeit für Dokumentation und 7% für Informationssuche).

Dokumentation in agilen Softwareprojekten weiterlesen

Projektflyer als Kurzinformation verfügbar

Um das Projekt sprintDoc kurz und knapp für Interessenten zusammen zu fassen, haben wir einen Fyler entwickelt. Der sprintDoc Projektflyer fasst die Herausforderungen und Ziele des Projekte wie folgt zusammen.

Herausforderungen

  • Agile Methoden fokussieren auf die schnelle Bereitstellung
    von funktionierenden Software-Komponenten und vernachlässigen
    dabei die Dokumentation
  • Erfahrungen verbleiben lediglich in den Köpfen des Teams
  • Hohes Wissensverlustpotential in Software-Unternehmen
  • Hoher Anteil an Abstimmungsbedarf und Informationssuchzeiten
    im Arbeitsalltag von Entwicklern
  • In der Praxis fehlt es an Methoden und Werkzeugen, welche
    den Dokumentationsprozess effektiv und effizient unterstützen

Projektziele

  • Untersuchung welche Dokumentationsarten benötigt werden,
    welche Relevanz diese haben und sich wie die Dokumentation in
    der agilen Projektmethodik integrieren lässt
  • Entwicklung eines Methoden- und Werkzeugsets für die
    Dokumentation in agilen Softwareprojekten
  • Prototypische Umsetzung und Evaluierung bei zwei
    Pilotanwendern

Finden Sie außerdem den zentralen Ansatz unseres Werkzeugkonzeptes sowie direkte Kontaktdaten zum Ansprechpartner an der Otto-von-Guericke-Universität.

Online-Befragung zur Dokumentation in agilen Projekten

Nachdem wir im Sommer die Analyse mit der Tätigkeitsanalyse, den Interviews und Erfahrungssicherungsworkshops bei den Pilotanwendern abgeschlossen haben, starten wir nun eine Online-Befragung zur Komplettierung der Analyse. Wir beginnen mit der Datenerhebung ab 02. November und hoffen auf eine rege Beteiligung. Der Fragebogen wird bis 21. Dezember zur Verfügung stehen.

Der Fragebogen richtet sich an eine breite Öffentlichkeit und soll eine möglichst hohe Anzahl von agil arbeitenden Softwareentwicklern erreichen. Wir möchten im Fragebogen Informationen zum Dokumentationsverhalten und Informationsbedarf in agilen Softwareentwicklungsprojekten sowie zu konkreten Anforderungen an ein unterstützendes Werkzeug erhalten. Bitte nehmen Sie sich 15 Minuten Zeit, um den Fragebogen auszufüllen. Wir freuen uns sehr auf Ihre Teilnahme!

Online-Befragung zur Dokumentation in agilen Projekten weiterlesen

Agile Softwareprojekte: Informationssuche & Dokumentation

Die Analyse bei unseren drei Softwareentwicklungsunternehmen ergab, dass im Schnitt 7 Prozent der Arbeitszeit mit dem Suchen nach Informationen verbracht werden. Lediglich 4 Prozent entfallen auf die Dokumentation. Die meiste Zeit (22 Prozent) verbringen Softwareentwickler in informellen Gesprächen.

Agile Softwareprojekte: Informationssuche & Dokumentation weiterlesen

Tätigkeitsanalyse bei Entwicklern abgeschlossen

Die vergangenen zwei Wochen haben wir intensiv genutzt, um bei unseren Pilotanwendern Thorsis Technologies und WIZMO die Tätigkeiten der Softwareentwickler zu analysieren. Wir gehen davon aus, dass die Arbeit eines Softwareentwicklers sehr stark fragmentiert ist, also häufig unterbrochen wird. Uns interessiert dabei insbesondere, wie häufig Entwickler nach Informationen suchen müssen und wie lange.

Tätigkeitsanalyse bei Entwicklern abgeschlossen weiterlesen

SprintDoc auf der Wissensgemeinschaften 2015

Im Projekt sprintDoc wollen wir auf den Vorarbeiten von CosmoCode (ICKEwiki bzw. DokuWiki) aufbauen, um ein geeignetes Dokumentationswerkzeug zu entwickeln. Auf der Tagung „Wissensgemeinschaften 2015“ in Dresden wird daher das hinter dem ICKEwiki stehende Konzept der strukturierten Wikis vorgestellt und an einem Praxisbeispiel erläutert. Außerdem werden wir die Zielstellungen von sprintDoc den Teilnehmern präsentieren und erhoffen uns dadurch zusätzliche Inspiration. SprintDoc auf der Wissensgemeinschaften 2015 weiterlesen