OK、いつも気になっていたことなので聞いてみます…
Discourse インスタンスから「新しいバージョン」が利用可能だというメールが届きます。
そのメールには「リリースノートで新機能を確認する…」というリンクがあります。
しかし、そのリンクをクリックすると、その新しいバージョンやそのリリースノートに関する記述がありません。
こちらをご覧ください - 「新しいバージョンは 2.5.2 です」と表示されていましたが、リンク先画面を見てみてください。2.5.2 のリリースノートについての記述はありますか？
つまり、そのリンクは私の助けになるどころか、むしろフラストレーションを募らせました。
これは私だけでしょうか？
2.5.2 は安定版で、変更は最小限です。新しいバージョンはベータ版です。
ありがとうございます。ただ、認識を合わせさせてください。
リンクには 2.5.2 リリースノートに移動すると書かれていますが、実際にはそうなりません。そのリンク/ページには 2.5.2 リリースノートに関する記載はどこにもありません。
先回の発表でも同じことがありました。
安定版アップデートについては、通常リリースノートを作成しません。それは、通常、極めて些細な変更であり、絶対に必要なバックポートされたバグ修正などに限られるためです。GitHub から特別なリンクを通じて安定版の変更を取得できる可能性がありますが、@jomaxro さんにアイデアがあるかもしれません。
一般的には、テストがパスしたバージョン（tests-passed）のままにしておくことをお勧めします。当社のすべての顧客およびホスティングサービスも、テストがパスしたバージョンを使用しています。
Jeff の指摘の通り、安定版リリースについてはリリースノートを作成していません。受信したメールはすべての Discourse インスタンスで共有される標準的なメールであり、どのブランチにいるかは認識していません。
安定版のマイナーリリースには、重要なバグ修正とセキュリティパッチのみが含まれます。通常リリースには数百もの変更が含まれるのに対し、安定版のマイナーリリースでは一般的に 10 件未満、多くの場合はそれよりさらに少ない変更しかありません。
すべての変更は https://github.com/discourse/discourse/commits/stable で確認できます。「Version bump to v{現在のバージョン}」と「Version bump to v{前のバージョン}」の間の変更が該当します。v2.5.2 の場合、変更は 7 件あります。その内訳は、セキュリティ関連が 3 件、セキュリティ変更へのフォローアップが 2 件、重要なパフォーマンス修正が 2 件です。
了解しました。安定版リリースに対してリリースノートを作成しないというあなたの考えには、ある程度納得できます。私の主張は、多くのユーザーがメール通知を受け取っているものの、そのほとんどでリリースノートのリンクには何も記載されていないという点です。一つの解決策としては、テンプレートを変更して期待値をより明確にすることです。そうすれば、私が「からかわれている」と感じたり、受信したメールに関連する内容が見つからずにクリックしてしまうことも減るでしょう。
もしこれが私たちの製品であれば、すべてのリリースに対して10分ほど時間を割いてリリースノートを作成します。
単に「これはマイナーリリースです。リスクは低く、主にバグ修正です。ただし、xxxの処理方法を変更しましたので、その改善点や潜在的な影響についてご存じください」といった内容で十分です。
ともかく、私はこれで満足です。
ビルさん、
社内での議論の結果、ご提案いただいた文言に変更することは見送ることになりました。ご理解いただけるかと存じますが、デフォルト通り「tests-passed」のままのサイトを推奨しつつ、今後は安定版リリースに対してリリースノートを作成していく予定です。ただし、安定版の更新はクリティカルなバグ修正とセキュリティパッチのみを含むため、通常のリリースノートほど詳細な内容にはなりません。
非常に良いことです。少し皮肉っぽくなってしまい申し訳ありませんが、新しいリリースのお知らせを受け取ると、すぐにリンクをクリックして、このリリースがユーザーにどのような影響を与えるか、アップグレードの優先度はどの程度かなどを確認したくなります。
しかし、そのリンクがそうした情報を提供してくれないことにいつもイライラさせられます。また、ほとんどの場合、アップグレードに関するドキュメントに同じバージョン番号が参照されていることはまずありません。そのため、リリースに特化したドキュメントを探すのにどのくらいの時間を費やすべきかを決めなければなりません。もちろん、「beta」やそれ以前のバージョン番号が記載されたドキュメントは、最終リリースと大きく異なる可能性があり、私にとっては役に立ちません。
この件を前に進めていただき、ありがとうございます。
今後の参考として、2.5.0 のようなメジャーな安定版のアップグレードにおける実効的な変更ログは、2.5.0.beta[1,2,3,4,5,6,7] のようにバージョンで始まるすべてのベータ版リリースの合計となります。私たちは「ベータ」版をいつでも使用可能な状態に保つよう努めており、「安定版」ブランチは「バグがない」ことよりも「変更がない」ことに重点を置いています。
パッチリリースノートが混乱の解消に役立つことを願っています。
最新の安定版パッチ 2 つのリリースノートが公開されました。
