Contact
QR code for the current URL

Story Box-ID: 869364

Micromata GmbH Marie-Calm-Straße 1-5 34131 Kassel, Germany http://www.micromata.de
Contact Ms Jule Witte +49 561 3167930
Company logo of Micromata GmbH

Agile Dokumentation.

TECH TALK mit Simon Krackrügge auf Micromata TV

(PresseBox) (Kassel, )
Agil ist weit mehr als ein Trend. Seit das Agile Manifest im Jahr 2001 das Licht der Welt erblickt hat, hat die agile Arbeitsweise eine beispielhafte Erfolgsgeschichte geschrieben. Da aber bei aller Flexibilität und Dynamik die Dokumention weiterhin wichtig bleibt, empfiehlt Simon Krackrügge eine agile Dokumentation.

Was ist eigentlich Agil?

Agil bedeutet, dass wir unsere Projekte nicht mehr stur nach einem anfangs gefassten Plan abwickeln. Es bedeutet, dass wir uns vielmehr auf Unwägbarkeiten einstellen und diese zulassen. Denn IT-Projekte sind wie Reisen: Egal, wie wasserdicht die Planung vor Reiseantritt erscheint, das Unerwartete geschieht.
Dies gilt insbesondere dort, wo die Technologien anspruchsvoll die Anforderungen komplex sind. Außerdem gibt es im laufenden Projekt auch fachliche Änderungswünsche, die beim Start noch nicht unbedingt abzusehen waren. Sei es, dass weitere Systeme angebunden werden müssen, sei es, dass die Nutzerlandschaft sich verändert hat oder dass weitere Dienste und Features zu integrieren sind: Die Liste der Eventualitäten ist lang.

Manifest für Agile Softwareentwicklung

Und so lautet das Manifest wörtlich:


„Wir erschließen bessere Wege, Software zu entwickeln, indem wir es selbst tun und anderen dabei helfen. Durch diese Tätigkeit haben wir diese Werte zu schätzen gelernt:
  • Individuen und Interaktionen mehr als Prozesse und Werkzeuge
  • Funktionierende Software mehr als umfassende Dokumentation
  • Zusammenarbeit mit dem Kunden mehr als Vertragsverhandlung
  • Reagieren auf Veränderung mehr als das Befolgen eines Plans
Das heißt, obwohl wir die Werte auf der rechten Seite wichtig finden, schätzen wir die Werte auf der linken Seite höher ein.“

Verfasser: Kent Beck, Mike Beedle, Arie van Bennekum, Alistair Cockburn, Ward Cunningham, Martin Fowler, James Grenning, Jim Highsmith, Andrew Hunt, Ron Jeffries, Jon Kern, Brian Marick, Robert C. Martin, Steve Mellor, Ken Schwaber, Jeff Sutherland, Dave Thomas. Erscheinungsjahr: 2001

http://agilemanifesto.org/...

… Und was ist dann Agile Dokumentation?

Hier setzt der TECH TALK von Simon Krackrügge an. Agile Methoden sind ja nicht von sich aus dokumentationsaffin. Sie sind im Gegenteil eher von Flexibilität geprägt und legen größeren Wert auf die spontane Handlungsfähigkeit innerhalb eines Projektes als auf dessen Dokumentation für die „Ewigkeit“. Entsprechend sind auch die Werkzeuge eher spontan: Zettel, Kanban-Boards, mündlicher Dialog.

Dokumentation bleibt aber weiterhin sehr wichtig. Denn Zettel, Dialoge und User Stories ersetzen einfach nicht die nachhaltige Speicherung von Wissen. Denn natürlich wollen wir dieses Wissen nicht nur simultan vermitteln, sondern auch über den engeren Wirkungskreis hinaus langfristig festhalten.

Die Vorteile nachhaltiger Dokumentation

Jeder kann sie in seinem Tempo lesen
Jeder liest sie dann, wenn er sich bestmöglich darauf konzentrieren kann
Die Teilhaberschaft ist insgesamt breiter
Wie verbinden wir also die Vorteile Nachhaltigkeit und Agilität in der Dokumentation?

Die Antwort lautet: Agile Dokumentation! Heißt: Wir dokumentieren bedarfsgerecht! Das gelingt uns, wenn wir uns im Vorfeld über die Leserschaft Gedanken machen – und darauf ausgerichtet Form und Inhalt wählen. So hängt beispielsweise die Beschreibung einer Software und ihrer Features oder die technische Detailtiefe davon ab, wer das Dokument am Ende liest. Denn weder wollen wir Leser der Fachseite mit technischen Einzelheiten quälen, noch die Leser aus dem IT-Bereich mit Überblicksdarstellungen vergraulen.

Wir fragen uns also „Wer liest das eigentlich? Und welche Informationen verspricht sich dieser Leser von der Lektüre?“ Das klingt banal, ist es aber nicht. Denn von der Leser-Zielgruppe hängt nicht nur ab, was, sondern auch wie wir es dokumentieren. Benutzerhandbuch ist nicht gleich Installationshandbuch ist nicht gleich Projektdokumentation.

Hier ein paar Beispiele

Produktdokumentation:
Diese geschieht mittels verschiedener Handbücher (Benutzerhandbuch, Betriebshandbuch, Online-Hilfe). Diese basieren in aller Regel auf den Formatvorlagen des Kunden und sind strengen Regeln unterworfen. Leserschaft: Je nach Handbuch die Nutzer, die Administratoren oder der Support einer Software

Systemdokumentation: Diese liefert eine Innensicht. Sie gibt Auskunft über Datenmodell, Architekturentscheidungen, Software- und UI-Design und hält Code-Kommentare fest. Leserschaft: Alle am Projekt beteiligten Stakeholder mit technischem Hintergrund

Projektdokumentation: Alles, was es zur Zielsetzung und zum Verlauf eines Projektes zu sagen gibt, wird hier festgehalten: User Stories, Epics, Backlogs, Use Cases. Leserschaft: Alle am Projekt beteiligten Stakeholder mit fachlichem Hintergrund

Prozessdokumentation: Hier geht es um die Frage nach dem Wie: Definition of Ready, Definition of Done, diverse Workflows auf Basis von Git, JIRA etc. Leserschaft: Projektmanagement, Entwicklungsmanagement

Website Promotion

Website Promotion
Homepage der Micromata GmbH

Micromata GmbH

Die Micromata GmbH entwickelt seit 1997 passgenaue Softwarelösungen für große Unternehmen aus den Bereichen Logistik, Automotive, Medizintechnik, Energie und Rohstoffgewinnung. Zu den langjährigen Kunden des Hauses zählen hauptsächlich DAX-30-Konzerne wie K+S, Volkswagen, E.ON, Deutsche Post DHL sowie B. Braun Melsungen, WINGAS und Wintershall. Micromata beschäftigt über 100 Mitarbeiter und führt neben dem Hauptsitz in Kassel eine Niederlassung in Bonn. Das Unternehmen ist wiederholter Preisträger des Innovationspreis-IT und wurde u. a. mehrfach mit dem Deloitte Technology Fast 50 ausgezeichnet. Laut der Studie Great Place to Work® gehört Micromata außerdem zu Deutschlands besten Arbeitgebern 2015 und 2017. Weitere Informationen sind unter www.micromata.de erhältlich.

The publisher indicated in each case (see company info by clicking on image/title or company info in the right-hand column) is solely responsible for the stories above, the event or job offer shown and for the image and audio material displayed. As a rule, the publisher is also the author of the texts and the attached image, audio and information material. The use of information published here is generally free of charge for personal information and editorial processing. Please clarify any copyright issues with the stated publisher before further use. In case of publication, please send a specimen copy to service@pressebox.de.
Important note:

Systematic data storage as well as the use of even parts of this database are only permitted with the written consent of unn | UNITED NEWS NETWORK GmbH.

unn | UNITED NEWS NETWORK GmbH 2002–2024, All rights reserved

The publisher indicated in each case (see company info by clicking on image/title or company info in the right-hand column) is solely responsible for the stories above, the event or job offer shown and for the image and audio material displayed. As a rule, the publisher is also the author of the texts and the attached image, audio and information material. The use of information published here is generally free of charge for personal information and editorial processing. Please clarify any copyright issues with the stated publisher before further use. In case of publication, please send a specimen copy to service@pressebox.de.