Moin zusammen,
Das Changelog lässt mich immer wieder stirnrunzelnd zurück.
Die Beschreibungen zu den Bugs sind durchaus irreführend. D.h. einmal ist der Text zu einem Bug eine Fehlerbeschreibung, ein anderes mal eine Korrekturbeschreibung.
Beispiel aus dem Wawi Changelog zur 1.0.11.1 (beides Bugs):
Bei 18040 beschreibt der Text offensichtlich die Korrektur. Bei 17447 ist es jedoch eine Problembeschreibung. Das ist irreführend und leider nicht immer so offensichtlich erkennbar ob das Problem oder die Lösung beschrieben wurde. Denn wenn beide Texte eine Problembeschreibung wären, wäre bei 18040 die Korrekturbuchung jetzt langsam. Anders herum, wenn beide Texte eine Beschreibung der Lösung wären, würden durch 17557 nun nicht mehr alle Bilder konvertiert.
Der Text sollte entweder eine Problem-, oder Korrekturbeschreibung sein - aber nicht mal so und mal so.
Oder was soll mir dieser Eintrag (Bug) sagen:
Der Informationsgehalt dieses Bugs ist mehr als sparsam. Das ist weder eine Problem-, noch eine Beschreibung was korrigiert wurde.
Bevor ich eine neue Version produktiv setzte teste ich einige für mich wichtige Funktionen. Aber bei dem Bug 16969 wüsste ich gar nicht, wo ich ansetzten sollte.
Ich würde mir ein Changelog wünschen, welches neben der Fehlermeldung, bzw. einer kurzen Problembeschreibung auch ausführt, was behoben wurde und welche Programmbereiche davon betroffen sind.
Zu einer guten Software gehört auch eine gute Dokumentation!
Das Changelog lässt mich immer wieder stirnrunzelnd zurück.
Die Beschreibungen zu den Bugs sind durchaus irreführend. D.h. einmal ist der Text zu einem Bug eine Fehlerbeschreibung, ein anderes mal eine Korrekturbeschreibung.
Beispiel aus dem Wawi Changelog zur 1.0.11.1 (beides Bugs):
| 18040 | Korrekturbuchung bei vielen Picklisten nicht mehr langsam |
| 17447 | Bilderkonvertierung konvertiert nicht alle Bilder |
Bei 18040 beschreibt der Text offensichtlich die Korrektur. Bei 17447 ist es jedoch eine Problembeschreibung. Das ist irreführend und leider nicht immer so offensichtlich erkennbar ob das Problem oder die Lösung beschrieben wurde. Denn wenn beide Texte eine Problembeschreibung wären, wäre bei 18040 die Korrekturbuchung jetzt langsam. Anders herum, wenn beide Texte eine Beschreibung der Lösung wären, würden durch 17557 nun nicht mehr alle Bilder konvertiert.
Der Text sollte entweder eine Problem-, oder Korrekturbeschreibung sein - aber nicht mal so und mal so.
Oder was soll mir dieser Eintrag (Bug) sagen:
| 16969 | Umsatzsteuer-ID bei IGL |
Bevor ich eine neue Version produktiv setzte teste ich einige für mich wichtige Funktionen. Aber bei dem Bug 16969 wüsste ich gar nicht, wo ich ansetzten sollte.
Ich würde mir ein Changelog wünschen, welches neben der Fehlermeldung, bzw. einer kurzen Problembeschreibung auch ausführt, was behoben wurde und welche Programmbereiche davon betroffen sind.
Zu einer guten Software gehört auch eine gute Dokumentation!