Wann ist der richtige Zeitpunkt für Dokumentation?

Produktdokumentation ist wichtig. Das habe ich jetzt verstanden, aber während des Sprints ist oftmals nicht viel Zeit. Das Team ist ausgelastet mit der Spezifizierung und Implementierung der Anforderung. Dann muss auch noch getestet werden und das Review bereitet sich auch nicht von alleine vor. Wann bleibt also noch Zeit für Dokumentation? Mache ich sie vor dem Sprint, danach oder doch währenddessen?

„Wann ist der richtige Zeitpunkt für Dokumentation?“ weiterlesen

Warum dokumentieren wir überhaupt?

In diesem Beitrag möchte ich mich damit beschäftigen, warum wir überhaupt dokumentieren. Dokumentation sollte kein Selbstzweck sein. Wir könnten sonst unsere wertvolle Zeit voll und ganz in die Entwicklung funktionierender Software investieren. Glaubt man dem IEEE-Standard 1471-2000 ist es die Kernaufgabe von Dokumentation, Fragen der Stakeholder zu beantworten. Kennt ihr die Fragen eurer Stakeholder? Kennt ihr eure Stakeholder?

„Warum dokumentieren wir überhaupt?“ weiterlesen

Softwaredokumentation – Ein vielschichtiger Begriff

Bevor ich in weiteren Blog-Artikeln über Dokumentation im agilen Umfeld schreibe, möchte ich mir zunächst einmal die Grundlagen zur Softwaredokumentation ansehen. Liest man den entsprechenden Wikipedia-Artikel soll eine Dokumentation zeigen, wie die Software funktioniert. Wie geht sie mit Daten um, was ist im Betrieb zu beachten und auf welcher technischen Grundlage wurde entwickelt? Das bedeutet, es kann gar nicht die eine richtige Dokumentation geben.

„Softwaredokumentation – Ein vielschichtiger Begriff“ weiterlesen

Funktionierende Software ist wichtiger als umfassende Dokumentation, aber…

Wie wichtig ist eigentlichen Dokumentation in der IT? Diese Fragestellung wird wohl schon solange diskutiert wie programmiert wird. Während fachliche Mitarbeiter am liebsten die gesamte Anwendung dokumentiert wissen wollen, reicht Entwicklern oftmals der Code selbst als Informationsquelle. Das agile Manifest entfacht diese Meinungsverschiedenheit erneut, indem es festhält: „funktionierende Software ist wichtiger als umfassende Dokumentation“. Was das für die agile Dokumentation und meine tägliche Arbeit als Business Analyst in einem Scrum-Team bedeutet, möchte ich in diesem Blog festhalten.

„Funktionierende Software ist wichtiger als umfassende Dokumentation, aber…“ weiterlesen