開発者以外向けに説明された変更ログとリリースノート

スマートフォンでiOSまたはAndroidのアップデートを入手できます。 ゲーマーは、World ofWarcraftまたはCallofDutyの新しいコンテンツパッチを入手します。 WordPressのプラグインとテーマに新しい機能が追加されました。 毎日使用するソフトウェアは定期的に更新されます。 その場合、修正または追加された内容を正確に示す変更ログが公開されます。

これらの変更ログの問題は、あなたがどちらかでない限り、読みやすく理解するのが非常に難しいことに伴うことがよくあります…

• プロジェクトに直接関与
• 技術文書と専門用語を読むことで訓練されたソフトウェア開発者

ほとんどの人にとって、変更ログの構造でさえ威圧的であり、それは彼らにメモを完全に無視させます。 これはいくつかの理由で悪いことですが、その中でも特に、ディスプレイウィジェット全体の大失敗とそのような問題（悲しいことにかなり一般的です）があります。

それでは、変更ログとは何か、リリースノートの読み方を分析し、可能な限り最新の情報を入手できるようにしましょう。

トーンとスタイル

企業や開発者が異なれば、変更ログへのアプローチも異なります。 いくつかは単純で、技術用語で更新が何をするかを正確に伝えますが、他の（最近のSlack更新からの以下の例でわかるように）新しいものについてユーザーに通知するためのより読みやすい（そしてしばしばユーモラスな）アプローチを求めます。

たとえば、WordFenceはセキュリティプラグインであり、メモを軽視する余裕はありません。 あまりにも多くの人が乗りすぎていますが、Slackのブランド全体は親しみやすく楽しいものです。

一般に、これらは表示される2種類のリリースノートです。 ただし、開発に携わっている場合は、はるかにあいまいに記述された変更ログが表示されます。 Githubをいじくり回さない限り、まったく理解できないものを見つけることはまずありません。

変更によって対処される問題の重要性もトーンを決定します。 たとえば、Slackがコードの脆弱性（神は禁じられている）によるデータ侵害の犠牲者だった場合、修正のパッチノートは暗くて安心できるでしょう。

しかし、結局のところ、

ポイントリリースとバージョン番号を理解する

変更ログの主要な構造は非常に単純です。 （通常は）小数で区切られた2つまたは3つの番号で構成されるバージョン番号（ 2.39または1.3.37）と、各リリースに付随するものの箇条書きリストがあります。

これらの番号にはそれぞれ特定の機能があります。 何を見ているのかがわかるように、一般的な用語で分類します。 更新が保留中であるという通知が常に表示されるためです。

3.xx

変更ログの最初の数字は、ソフトウェアのプライマリバージョン、メジャーリリース、全体的な機能を変更する大幅な改善を加えてソフトウェアがリリースされた回数を示します。

たとえば、iPhoneをiOS 11にアップデートする場合、技術的にはバージョン11.0.0にアップデートします。 AndroidOreoを入手した場合も同じです。バージョン8.0です。 通常、ソフトウェアの最初の数が更新されると、以前とは大幅に異なるエクスペリエンスが得られます。

ゲーマーの場合は、拡張がメジャーリリースであることを考えてください。 2004年のWorldof Warcraftの最初のリリースはバージョン1.0でしたが、The Burning Crusadeは2.0で、現在の拡張版であるLegionは7.0でした。

Diviでは、2.7から3.0へのリリースは、DiviBuilderをまったく新しいVisualBuilderに作り直したものであり、これにより、すべての人に大きな変化がもたらされました。

x.1.x

2桁目は、追加された新機能やバグが修正された場所です。 2桁目（および3桁目）は、「7ポイント3ポイント4」のように読み上げられるため、ポイントリリースと呼ばれます。

これらの追加により、アプリまたはプラグインの側面が変更される可能性がありますが、メジャーリリースのような基本機能は変更されません。 Diviが新しいモジュールを追加するとき、またはiOSまたはAndroidが新しい絵文字を追加するとき、バージョン3.1または10.3でそれを取得します。

WordPressプラグインについては、YoastSEOをご覧ください。 バージョン5.5.0では、いくつかのバグ修正と機能拡張が提供されていますが、ここでは驚異的なことは何もありません。 基本的に、ソフトウェアがポイントリリースでどのように機能するかを再学習する必要はありません。

これらのポイントリリースは、ビデオゲームで新しいレベルまたはシステムを取得したときに行われます。 以下に示すように、バージョン2.2。 キングダムハーツモバイルアプリの2.3にペットシステムを追加しました。 それはゲームのプレイ方法を変えることはありませんが、すでにあるものの上に何かを追加します。

xx7

リリースノートの3桁目と最後の桁で、変更ログは（せいぜい）マイナーなバグ修正でいっぱいになる可能性があります。 または、おそらく気付かないような背景の変更/改善。

Facebookはこの種のポイントリリースで有名です。 彼らのアプリは毎週更新され、（ほとんどの）ユーザーが毎日の使用で気付くような変化はほとんどないかもしれません。

多くの場合、これらのマイナーポイントリリースは「ホットフィックス」と呼ばれるものです。 これらは、ほとんどのユーザーが存在すら知らない問題に対処するパッチにすぎません。 これらの修正プログラムのほとんどは、特定のブラウザバージョンでフォントが壊れているなどの問題を修正します。 または、特定のオペレーティングシステムでメモリリークが発生している可能性があります。 多くの場合、これらの修正は「互換性の問題」のような一般的なものとしてラベル付けされています。

場合によっては、開発者が次のコンテンツパッチ（または定期的にスケジュールされた更新）を待つことができないと見なす問題の修正プログラムを入手することがあります。 繰り返しますが、それはあなたに影響を与えるかもしれませんし、影響を与えないかもしれません。

5.3.2から5.3.3にYoastに加えられた更新でわかるように、更新は比較的マイナーですが、「特定の状況」では重要です。

野生のチェンジログ

例として、いくつかのメジャーリリースに関するDiviのリリースノート/変更ログを見てください。 2.7から3.0.1の間で、行われた変更の種類を確認できます。 いくつかのメジャー（新しいVisual Builderのリリース）といくつかのマイナー（WordPress 4.6のみのフォント変更）。

version 3.0.1 ( updated 09-08-2016 )
- Fixed various third party module conflicts in the Visual Builder.
- The save button will now appear automatically when attempting to leave the Visual Builder without saving.
- Fixed issue with content width misalignment in the Visual Builder while boxed layout was enabled.
- Fixed occurrences where the in-line editor did not save properly
- Added footer credits editor to Theme Customizer.
- Fixed issues with IE11 and the Slider Module when viewed inside the Visual Builder.
- Fixed problem with the rendering of the divider module height setting in the Visual Builder.
	

version 3.0 ( updated 09-07-2016 )
- Introducing the brand new Visual Builder: https://www.elegantthemes.com/blog/theme-releases/divi-3

version 2.7.10 ( updated 08-18-2016 )
- Fixed the issue with the Divi Builder not loading on some websites due to loading delay of TinyMCE in the latest version of WordPress.


version 2.7.9 ( updated 08-15-2016 )
- Fixed settings page font issues in WordPress 4.6

この記事の執筆時点では、現在バージョン3.0.78です。 これまで、変更は比較的微妙な追加と調整でした。 それらは重要で素晴らしいものであり、私たちはそれらを非常に誇りに思っていますが、3.0.0のリリースから現在までの78の更新は、ElegantThemesメンバーの生活をより良くするために繰り返されます。 3.1が来るとき、あなたはそれが素晴らしいものになるだろうということを知っています。

そして4.0？ 男、ああ、男…私たちは想像することしかできません。

変更ログに細心の注意を払ってください

プラグイン、アプリ、またはテーマの更新に付属する変更ログを常に読む必要があります。 上でリンクしたWordfenceの記事に記載されているように、プラグインは販売されます。 元の開発者を信頼している場合でも（そして新しい開発者も同様に信頼できる場合があります）、所有権の変更に注意する必要があります。

変更ログは、そのようなことについて知る場所です。 すべての更新と追加があなたの経験を変えるわけではありません。 ただし、少なくともメモを一瞥して何が違うのかを確認することは常に良いことです。 情報を常に入手することは、メモを読むのにかかる30秒の価値があることは間違いありません。

そして、ここに問題があります。あなたが読んだものを完全に理解していなくても、それは大丈夫です。 実際、それは正常です。 変更ログは透明性の文書と記録であり、四半期ごとの更新や電子メールのニュースレターではありません。

これを言うのは危険ですが、変更ログの内容を理解していなければ、その問題はおそらく問題ではないのではないかと思います。 （もしそうなら、彼らは他の人々にとっても重要であり、オンラインで他の人々のためにそれを分解することができ、そして分解するでしょう。）

重要なことは、リリースノートの基本的な構造を理解していることです。 数字と用語の意味を知っておく必要があります。 そして、最終的には、変更ログをスキャンして重要な情報を見つける方法を学びます。

変更ログを利用するために、開発者（または技術者）である必要はありません。 あなたはただ何を探すべきかを知る必要があります。

r.kathesi / shutterstock.comによる記事のサムネイル