OK – ich habe mich das schon immer gefragt, also werde ich es fragen…
Ich erhalte E-Mails von unserer Discourse-Instanz, die mir mitteilen, dass eine „Neue Version
2.5.2 ist stabil, mit minimalen Änderungen; die neuen Versionen sind Beta.
Danke – aber nur damit wir auf einer Linie sind…
Der Link sagt, er führt mich zu den Versionshinweisen für 2.5.2. Das tut er aber nicht. Nirgendwo auf dieser Seite/unter diesem Link werden die Versionshinweise für 2.5.2 erwähnt.
Das Gleiche ist bei der letzten Ankündigung passiert.
Für stabile Updates stellen wir in der Regel keine Release-Notes bereit, da es sich dabei meist um sehr geringfügige Änderungen handelt – etwa um absolut notwendige, zurückportierte Fehlerbehebungen usw. Es ist möglich, dass Sie die Änderungen für das stabile Release über einen speziellen Link von GitHub beziehen können; vielleicht hat @jomaxro dazu eine Idee.
Wir empfehlen generell, bei „tests-passed
Jeff hat recht, ich schreibe keine Versionshinweise für stabile Releases. Die E-Mail, die Sie erhalten haben, ist eine Standard-E-Mail, die von allen Discourse-Instanzen verwendet wird. Sie weiß nicht, auf welchem Branch Sie sich befinden.
Stabile Punkt-Updates enthalten nur kritische Fehlerkorrekturen und Sicherheitspatches. Im Gegensatz zu unseren normalen Releases, die Hunderte von Änderungen enthalten, haben stabile Punkt-Updates in der Regel weniger als 10, oft sogar deutlich weniger.
Sie können alle Änderungen unter https://github.com/discourse/discourse/commits/stable einsehen. Suchen Sie nach „Version bump to v{aktuelle Version}
Verstanden. Deine Begründung, warum keine Release Notes für stabile Releases erstellt werden, ergibt irgendwie Sinn. Mein einziger Punkt ist, dass VIELE von uns E-Mail-Benachrichtigungen erhalten und in den MEISTEN Fällen der Link zu den Release Notes nichts zu sagen hat. Eine Möglichkeit wäre, die Vorlage so anzupassen, dass die Erwartungen besser gesetzt werden, anstatt dass ich getäuscht werde und meist klicke, um nichts zu finden, das mit der E-Mail zusammenhängt, die ich gerade erhalten habe.
Wenn es unser Produkt wäre, würde ich 10 Minuten investieren, um für jedes Release eine Release Note zu erstellen.
Einfach sagen: „Dies ist ein Minor-Release. Geringes Risiko. Hauptsächlich Bugfixes. Wir haben jedoch geändert, wie xxx behandelt wird, falls du über diese Verbesserung oder mögliche Auswirkungen informiert sein möchtest.
Ich schlage vor, die E-Mail-Vorlage für Standardversion-Updates zu aktualisieren:
Ersetzen Sie
“Sehen Sie sich an, was es in den Versionshinweisen Neues gibt”
durch
“Stöbern Sie in diesen Versionshinweisen und versuchen Sie herauszufinden, was in dieser neuen Version enthalten ist, da es keine Versionshinweise für diese Version gibt”
Hintergrund
Heute habe ich erneut eine E-Mail erhalten, dass 2.7.1 verfügbar ist, mit dem Hinweis auf den Link zu den Versionshinweisen, der jedoch keine Hinweise für 2.7.1 enthält. Der Link sollte entweder hilfreich sein oder weggelassen werden.
Hallo Bill,
wir haben intern diskutiert. Wie du sicher verstehst, werden wir den Text nicht wie von dir vorgeschlagen ändern. Obwohl wir nach wie vor empfehlen, dass Sites beim Standardwert „tests-passed
Sehr gut. Ich entschuldige mich für meine bissige Bemerkung, aber sobald ich die Ankündigung für eine neue Version erhalte, möchte ich sofort auf den Link klicken, um zu sehen, wie sich diese Version auf meine Benutzer auswirkt und wie dringend ein Upgrade ist usw. Doch ich bin stets frustriert, weil der Link das nicht leistet, und in den meisten Fällen werden in den Upgrade-Dokumenten niemals Dokumente mit derselben Versionsnummer referenziert. Jetzt muss ich entscheiden, wie viel Zeit ich in die Suche nach spezifischen Dokumenten zu dieser Version investieren soll. Offensichtlich können Dokumente mit „Beta
Für zukünftige Referenz: Das effektive Änderungsprotokoll für ein großes stabiles Update, wie z. B. 2.5.0, ist die Summe aller Beta-Releases, die mit der Versionsnummer beginnen: 2.5.0.beta[1,2,3,4,5,6,7]. Wir bemühen uns, die „Beta“-Versionen jederzeit brauchbar zu halten, und unser „stabiler“ Zweig konzentriert sich mehr auf das Fehlen von Änderungen als auf das Fehlen von Fehlern.
Hoffentlich helfen die Patch-Release-Notizen bei der Klärung der Verwirrung.
Die Release-Notizen für die letzten beiden stabilen Patches sind verfügbar.