リリースノートの実践

エンタープライズ向けリリースノート:一つのアカウントで何が変わるか

1分で読めます

公開SaaS製品は全員に同じリリースノートを送る。全員が同じバージョンにいるからだ。固定された バージョン、専用インスタンス、または機能フラグ付きの製品のサブセットにいるエンタープライズ 顧客は、その前提を崩す。彼女にとって何が変わったかを説明するリリースノートは、あなたの公開 ブログにあるものと同じではなく、それでも公開のものを送ることは、まだ持っていない変更で顧客を 混乱させるか、もっと悪いことに、別のエンタープライズ顧客のアカウントチームが、自分たちには あと一か月伏せておいてほしいと明確に求めた機能について彼女に話してしまう。リリースノートの ベストプラクティスは一般的な技術を扱っている。これは、 顧客全員が同じビルドにいるわけではなくなった時に現れる調整の問題のために、エンタープライズ 向けリリースノートをどう書くかについてだ。

なぜエンタープライズ顧客は単に公開チェンジログを読むことができないのか

それは、彼女がまだ実行していないかもしれないバージョン、アクセスできないかもしれない機能、 そして彼女自身のものと一致しないスケジュールを記述しているからだ。四半期ごとのリリースサイクル に固定され、先週公開層に出た機能について読んでいる顧客には、公開チェンジログだけからは、その 機能が来週彼女に届くのか来四半期に届くのかを知る方法がない。公開チェンジログは「製品で何が 変わったか」に答える。エンタープライズ顧客の実際の質問は「私が実行しているバージョンで何が 変わったのか、そしていつ残りを手に入れるのか」であり、公開チェンジログはそれに答えるために 書かれたことは一度もない。

非公開リリースノートは、公開のものが必要としない何を必要とするのか

顧客が実際に照合できるバージョンまたは環境の識別子と、まだ彼女に届いていないものの明示的な 記述だ。「このリリースには、私たちの公開4.3リリースからの一括エクスポートの改善が含まれて いますが、あなたの次の予定されたアップデートで届く新しい権限モデルは含まれていません」は、 エンタープライズ管理者に、彼女のインスタンスが製品全体に対してどこに位置するのかを正確に 伝える。公開リリースノートは、相対的であるべきインスタンスが一つしかないので、この枠組みを 決して必要としない。非公開のものはそれなしでは無意味だ。

公開リリースノート非公開(エンタープライズ)リリースノート
一つのバージョン、一つの読者層複数のバージョン、セグメント化された読者層
読者が記述されたすべての機能を持っていると仮定する読者が何を持っていて何を持っていないかを述べなければならない
公開リリースに合わせてタイミングを取る顧客自身のアップデートウィンドウに合わせてタイミングを取る
すぐに完全に公開できる他の顧客がまだ持っていない項目を保留する必要があるかもしれない

公開リリースノートをエンタープライズ顧客に送るのを別に書く代わりに単に遅らせることが許される場合はあるか

彼女のバージョンがその時点で本当に公開のものと一致している場合のみで、それは複数のリズムの 異なるエンタープライズアカウントを持つとすぐに、思うよりも稀なことだ。公開ノートを遅らせる ことは、一つバージョンが遅れていて追いつこうとしている顧客にとっての一時しのぎとして機能する。 それは、二人のエンタープライズ顧客が互いに異なるバージョンにいる瞬間に崩壊する。なぜなら その時点で遅らせるべき単一の「ノート」はもはや存在せず、それぞれが持っているものの行列だけが あるからだ。その時点で、たとえ同じ基礎となる項目のフィルタリングされたビューにすぎなくても、 アカウントごとにノートを調整することは、オプションであることをやめる。

まだその機能を持っていないエンタープライズアカウント
に送られた公開ノート:
"New: Bulk export now supports custom column ordering."
(混乱:管理者が試すとそこにない。)

同じアカウント向けに調整されたエンタープライズノート:
"Available in your next update (scheduled for 2026-10-15):
bulk export with custom column ordering. Not yet available
on your current version (3.8)."

顧客の組織内で実際にこれを読むのは誰であり、それは書き方を変えるか

通常はエンドユーザーではなくITアドミンかカスタマーサクセスの担当者であり、それは何が有用と みなされるかを変える。エンドユーザーは自分の画面で何が違って見えるかを知りたい。エンタープ ライズ管理者は、権限、データ処理、SSO設定、または自身のユーザーのためにデプロイメントを どう管理するかに影響する何かで何が変わったかを知りたい。なぜなら内部の質問に答えるのは 彼女になるからだ。すべてが新しくて光る新機能ボタンで運用的な詳細が一切ない、消費者向け チェンジログのように読める非公開リリースノートは、管理者に本当に必要だった情報を掘り出す ことを強いる。

これは、同じ機能をすでに掲載している公開ロードマップや公開チェンジログとどう相互作用するか

慎重に。なぜなら両方を読む顧客はどんな矛盾にも気づくからだ。公開チェンジログがすでに特定の エンタープライズアカウントがまだ持っていない機能を告知しているなら、その非公開リリースノート は、公開項目が存在しないふりをするのではなく、そのギャップを認めなければならない。公開の 発表を見て、それを無視する非公開ノートを受け取る管理者は、あなたが彼女を忘れたか、何かが 壊れていると想定するだろう。公開ロードマップは、何が出荷された かと何が計画されているかについてロードマップを正直に保つ方法を扱っている。リリースノートに おけるその正直さのエンタープライズ版は、公開されているものと彼女のものとの間のギャップを 直接名指しすることだ。

エンタープライズ顧客が一人か二人しかいない小さな会社は、これほど多くの構造を必要とするか

完全にセグメント化されたシステムではないが、顧客がどのバージョンにいて、何を持っていて何を 持っていないかを明確に述べる中核的な規律は、最新のビルドにいない顧客が一人でもいる瞬間から どんな規模でも重要になる。これが防ぐ失敗モード、公開の発表が自分に適用されるのか混乱している 管理者は、エンタープライズアカウントが二つであろうと二百であろうと、サポートチケットと信頼へ の打撃という代償を払う。

FAQ

非公開リリースノートは、他の顧客がすでに持っているがこの顧客が持っていない機能に言及すべきか? 彼女自身のスケジュールに関連する場合のみで、他の顧客との比較としてではなく「あなたの次の アップデートで届きます」として表現される。特定の他の顧客が何を持っているかを名指しすることは、 あなたが開示すべきではない領域に踏み込む。この顧客に特に何が届くかを名指しすることは、正確に 彼女が必要とする情報だ。

同じ基礎となるチェンジログの項目が、公開と非公開の両方のリリースノートを支えることができるか? できる、そしてそれは通常より保守しやすいアプローチだ。項目にどのバージョンや層に適用される かのタグを付け、公開時に読者層でフィルタリングする方が、必然的にずれていく二つの完全に別々の 文書を書くよりも良い。

エンタープライズ顧客が非公開フィードの代わりに公開リリースノートに載ることを明確に求めた場合はどうするか? それを尊重するが、公開ノートが公開バージョンを前提としていることを彼女が理解しているか確認し、 彼女のバージョンが記述と異なる場合は自分自身でそのギャップを書面で示そう。その書面での確認は、 実際には彼女のビルドに適用されなかった公開ノートに基づいて彼女が行動した場合、後であなたを 守るものだ。

エンタープライズ顧客は、次のリリースでアクセスできるようになる機能について、どれくらい前もって知らされるべきか? リリースの時点だけでなく、日付が確定次第すぐにだ。なぜならエンタープライズ管理者は、近づいて くる機能をめぐって自分自身の内部コミュニケーションやトレーニングを計画する必要があることが 多く、当日の通知はそのための余地を彼女に残さないからだ。


この記事の技術的な記述は第三者による確認を受けていません。誤りがあればお知らせください。修正します。

changeloopの関連ページ: リリースノートのテンプレート, changelogツール比較

changeloop
ループを閉じるchangelogを作っているチームです。ユーザーが何かを求め、あなたのチームがそれを届け、求めた人がそれを知る。