Ich glaube mit jeder Dokumentation, dass der agile Ansatz gut ist. Nun, es gibt einige Missverständnisse, dass Agilität "überhaupt keine Dokumentation oder Analyse" bedeutet, aber das ist nicht der Fall. Die Dinge, die ich über Agilität gelesen habe, sagen: "Nutze, was funktioniert." Ich verstehe das so, dass das Dokument von Länge und Detail sein sollte, die der Aufgabe entsprechen.
Vorlagen können als Checkliste hilfreich sein, aber ich würde nicht verlangen, dass jeder Abschnitt für kleine oder risikoarme Änderungen ausgefüllt wird. Für einen einzeiligen Wechsel benötigen Sie möglicherweise überhaupt kein Dokument. Ich habe noch nie eine Vorlage für ein Dokument zur Wirkungsanalyse verwendet, beschäftige mich jedoch regelmäßig mit Geschäftsanforderungen oder technischen Spezifikationen. Eine Vorlage kann zu restriktiv sein. Eine gute Richtlinie ist stattdessen zu überlegen, wer das Publikum sein wird. Wenn es sich um Manager handelt, die nicht technisch sind, konzentrieren Sie sich auf die geschäftliche Begründung für die Änderung. Wenn es sich um technische Mitarbeiter handelt, geben Sie einen kleinen Hintergrund an, damit eine neue Person im Team nicht verloren geht, und geben Sie ihnen genug, um loszulegen, wenn sie die Änderung unterstützen müssen. Wenn Sie etwas noch reibungsloseres und leichteres möchten, verwenden Sie überhaupt kein Dokument, sondern stellen Sie es in ein Wiki.
Zu enthaltende Informationen:
- Kurze Beschreibung des Problems
- Erklären oder zeigen Sie ein Beispiel dafür, wie ein Defekt zu Fehlern und / oder Ineffizienz führt
- Schätzung der Komplexität einschließen
- Geben Sie eine Schätzung der Kosten und der Zeit für die Korrektur an
Das ist ein anständiges Minimum. Der andere Beitrag hob einige ziemlich schwere CMMi-Sachen von IBM hervor; Das ist großartig, wenn Sie die Zeit und die Ressourcen dafür haben (und wenn Sie Systeme für die NASA bauen, bei denen es um menschliches Leben geht, dann nehmen die Leute es besser ernst), aber für kleine Teams müssen Sie wahrscheinlich nicht so schwer sein . Seien Sie wie immer vorsichtig mit der Schätzung. Manager neigen dazu anzunehmen, dass eine Schätzung die tatsächliche ist.
Beachten Sie, dass der agile Ansatz Gefahren birgt. Einige Entwickler glauben, dass dies bedeutet: "Keine Dokumente erforderlich, fangen Sie einfach an zu hacken" (was in einigen Situationen in Ordnung sein kann). Andere nehmen auch den Spielraum, der für die Aufgabe gegeben ist, und schreiben einfach wirklich beschissene Dokumente, die nicht wirklich helfen (in den meisten Situationen nicht unbedingt in Ordnung). Ein Teil des Problems besteht darin, dass gutes Schreiben einige Anstrengungen, Fähigkeiten und Zeit erfordert. den meisten von uns fehlen mindestens zwei dieser Dinge;)
Ich habe mich immer intensiv mit Dokumentation beschäftigt, weil dies beweist, dass Sie zumindest genug darüber nachgedacht haben, um sich als Plan zu qualifizieren. Aber in meinem Alter habe ich auch erkannt, dass zu viel Dokumentation selbst zu einem Wartungsproblem werden kann und dass nicht genug Leute sich genug um die Aktualisierung der Dokumentation kümmern.