本文へスキップ
表示言語: 日本語
デザイン / Signal

プロダクトの変更履歴: 更新後にユーザーは何をすればよいのか

更新の対象、変更内容、必要な行動を説明し、利用条件と現在の手順を分かりやすく結びます。

記事の言語: 日本語

白く光る花びらに触れる女性と、そばで休む猫。
目次

「エクスポートを改善しました」。よい知らせですが、明日のファイルにも同じ列があるか確かめたい人には、それだけでは足りません。チームは十数件の作業を完了しましたが、顧客が取り組むことは一つです。同僚が受け取れる形式で集計を送ること。そのために自分が何かする必要があるのかを知りたいのです。

プロダクトの変更履歴は、リリースされた更新がユーザーに与える影響を説明する必要があります。バージョン番号と日付は状態の識別に役立ちます。さらに、誰に関係するのか、実際に何が変わったのか、どの行動が必要なのかを伝えなければなりません。チームの喜びだけでは機能の利用可能範囲は分かりません。

備品リストを作る架空のサービス Półka を考えてみましょう。チームは、バリエーションを別々に表示するエクスポートを追加しました。新機能は一部のアカウントで利用でき、従来のファイルも引き続き使えます。一方、取引先の既存テンプレートは古い列名を前提としています。この例を使い、インポート失敗後ではなく、ファイルを取得する前に役立つ情報を考えます。

まず変更が誰に関係するか示す

記事の公開日と、機能を使えるようになる時点を分けてください。来週の予定を今日予告することも、グループごとに段階的に提供することもあります。「新しいエクスポートを利用可能」という見出しには、どこで誰が使えるのかを補う必要があります。機能がない人が、まず自分の見方が間違っているのではと疑うようにしてはいけません。

記事には、アカウントの種類、製品バージョンなど、利用を実際に決める条件を示します。社内の展開略号から推測させないでください。設定やバージョン番号を確認する必要があるなら、その場所までの道順を示します。公開前にプロダクトオーナーが条件を確認するべきです。

Keep a Changelog は、重要な変更を人が読むために時系列で記録し、種類別にまとめる方法を提案しています。今後の変更は Unreleased セクションに置き、リリース済みバージョンと分けています。プロダクトの読者に合わせて調整できる、有用な編集上の慣例です。

顧客に意味のない作業名を公開画面に持ち込まないでください。「B グループ向けエクスポート v2」は技術チームには通じるかもしれません。備品リストの担当者には、新しいエクスポート方法と具体的な利用条件を示す方がよいでしょう。管理者が機能を有効にするなら、その役割と必要な行動を明記します。

社内の情報伝達でも、受け手の作業から変化を説明する方法 (ポーランド語)として似た区別を扱っています。プロダクトの変更履歴には、利用可能性を後からたどれる記録が加わります。一か月後に戻った人が、記事はまだ予告なのか、使える状態の説明なのかを見分けられるようにします。

「ベータ」「プレビュー」「試験提供」といった表示が、普段の仕事に何を意味するか説明してください。試用できるだけなのか、通常の業務で頼ってよいのか、どの制限が残るのか。小さな注記ですべての文の意味を弱める飾りにしてはいけません。重要な部分の動作がまだチームにも分からないなら、その範囲を記事に明記します。

GitHub のリリース管理手順は、下書きの保存、公開、本番の準備ができておらず不安定な可能性を示すプレリリース指定を区別して説明しています。これは特定のツールにおける区別です。記事を作成しただけでは、顧客が使う環境で変更を利用できる証拠にはなりません。

一つの変更に一つの説明を付ける

Półka では「備品のバリエーションを表示するエクスポート」という見出しで話題を予想できます。最初の文では、新しいファイルが各項目にバリエーション列を追加すると説明できます。次の文で、誰が利用でき、どこで選ぶのかを示します。レイアウトの詳細はその後で説明できます。

変更カードでは四つの質問に答えます。

  • 何が違うか: 新しいファイルには独立したバリエーション列があり、以前の形式も選べます。
  • 誰に関係するか: 確認された範囲に従い、示された提供段階に含まれるアカウントです。
  • 何をするか: 独立したバリエーション列が必要なら、受取先との互換性を確認して新形式を選びます。それ以外の場合は以前の形式を使い続けられます。
  • 詳細をどこで確認するか: 列の説明と、承認済みの構造を示すサンプルファイルです。

これは特定の解決策についての架空のカードであり、あらゆる更新に使う万能なひな型ではありません。誤字の修正に四つの段落は不要です。一方、その後の行動に影響する変更では、判断に必要な情報をすべて残します。文章の長さはプロジェクトで完了した作業の数ではなく、影響に合わせて決めてください。

同じ架空の項目を含む以前のファイルと新しいファイルを、小さな例として添付できます。更新対象でない限り、商品名や行の順番まで同時に変えないでください。読者が見るべきなのは構造の違いであり、比較できない二つの図の謎ではありません。後から保存したファイルも変更履歴を開かず識別できるよう、例には形式とバージョンを記します。

「性能を改善しました」とだけ書く代わりに、具体的な操作と確認済みの結果を説明します。チームが特定の種類のリスト作成を調べたなら、その結果をサービス内のすべての作業に広げないでください。比較できる測定がなければ、何パーセント速くなったと約束せず、動作の変化を説明します。

スクリーンショットは新しい選択肢を探す助けになりますが、正しい状態と説明を示す必要があります。画面を変更したときは短い文章の手順があれば、画像の細部を読まなくても操作を理解できます。手順のそばには機能の利用条件も残してください。ボタンの画像だけでは、更新対象外のアカウントにボタンがない理由は分かりません。

大きなファイルでは、待機中の動作も説明します。新しいエクスポートが長時間の処理を開始するなら、結果をどこで受け取るか、タブを離れてよいかをユーザーに伝える必要があります。その経路は長い処理の進捗と復帰 (ポーランド語)で詳しく扱っています。変更履歴が変化を示し、実際の画面はその説明に応える必要があります。

Aeneiaのコンセプト写真

機能そのものから説明に戻る経路も確認してください。新しいエクスポートの選択肢の横に短いリンクがあれば、形式を選ぶ前に違いを理解できます。数十件の記事がある一般ページに移動すると、ユーザーは再び探さなければなりません。特定の更新を指し、作成中のリストに戻る方法も残しましょう。

機能終了の警告には日付と次の道筋が必要

形式の廃止を予告することと、実際に削除することは異なります。ユーザーは今何が動き、いつまで使え、何を準備すべきかを知る必要があります。期限がグループや契約によって異なるなら、該当する範囲を書いてください。一つの一般的な見出しから推測させてはいけません。

この例では以前のエクスポートを引き続き利用できます。そのため、すべてのテンプレートを直ちに移行しなければならないような書き方は避けます。後にチームが旧形式の停止を決めたら、影響と利用できる支援を説明する別のお知らせが必要です。以前の予告は日付を残しつつ、現在の状態に関連付けられます。

重要な警告を知らせる唯一の経路がアーカイブだけでは不十分です。形式が停止する前にテンプレートの準備が必要なら、普段の作業中にどこで知らせるかをプロダクトオーナーと決めます。例えば、エクスポート画面の案内から詳細にリンクできます。変更履歴は後から参照できる説明の場ですが、従来の作業ができなくなって初めて期限に気付くようでは困ります。

準備済みのファイルや開始済みの処理がどうなるかも示してください。新しいエクスポートの既定形式が変わっても、以前保存した資料を必ず作り直すとは限りません。読者にはこの区別が必要です。なければ、不要なやり直しをしたり、意図しない別のファイルを取引先に送ったりするかもしれません。

更新を取り消したら、変更履歴も現在の状態を反映するべきです。機能が一時的に消えたのに「全員が利用可能」という案内を残さないでください。影響範囲、作業を行うために利用できる方法、追加情報の入手先を説明します。前の記事をただ削除すると、すでに読んだ人は文脈を失います。

Aeneia Design バージョンと利用可能性をユーザーの具体的な行動につなぐ変更履歴を設計できます。更新カードと、手順やサービス内の作業場所へのつながりを整理します。 更新の影響をユーザーに伝える

アーカイブは過去の質問にも答える

記事のアドレスを識別しやすく保ち、特定のバージョンにたどり着けるようにしてください。サポート担当者が会話中にリンクを送り、ユーザーが時間を置いて戻ることもあります。リストの配置を変えても、この参照を切ってはいけません。内容を移動する際は、正しい情報にたどり着く経路を残します。

最新の記事は、それぞれのカードを開かなくても主題と日付が分かるように表示します。大きなアーカイブでは、人が実際に探す基準が役立ちます。製品の領域、変更の種類、バージョンなどです。会社が新しい欄から業務フロー全体の変更まで何でも「改善」と呼ぶなら、そのフィルターはあまり役に立ちません。

変更履歴と現在の手順を分けてください。記事はある時点で何が変わったかを説明し、手順は今の作業方法を説明します。今日エクスポートを作る方法を知るために、新しいユーザーに二年分の更新を読ませないでください。二つの資料を適切な場所で関連付け、それぞれの目的を明確にします。

ダウンロード資料センター (ポーランド語)には、正しいサンプルのバージョンと用途を示す必要があります。記事が新しい列を説明しているのに、リンク先のファイルが古い構成を示すなら、情報全体が矛盾します。公開前にはアドレスだけでなく、ファイルの内容も確かめてください。

複数言語では、状態と日付、手順を一致させます。多言語の提案書のバージョン管理 (ポーランド語)は、並行する内容で決定事項が食い違う問題を示しています。デジタル製品でも同じように、一方の言語の記事がまだ予告を説明しているのに、別の言語では機能の提供開始を告げていないか確認します。

より大きな対外発表では、事実と資料を備えたプレスセンター (ポーランド語)にリンクできます。報道向けの発表とユーザー向けの変更履歴は読者が異なりますが、何が開始されたかは一致しなければなりません。企業の成功を語る内容が、確認済みの製品状態を先取りしてはいけません。

最新状態を保つ担当者を決める

公開前にプロダクトオーナーが動作と利用可能性を確認し、編集者が分かりやすさを点検します。この手順はCMS でのコンテンツ公開プロセス (ポーランド語)と結び付けられます。記事の承認は、説明した機能が対象グループで実際に動くことの確認には代わりません。

公開前には短い説明と本文も比べてください。リストには「全員向けエクスポート」とあり、本文には限定的な提供段階が正しく示されているかもしれません。どちらも同じ情報の一部です。更新へのメッセージやバナーも確認します。強い見出しにするため範囲を広く約束せず、最も重要な条件を残してください。

製品を知っていても、更新の作業には参加していない人に下書きを見せます。変更がすでに自分に関係するか、行動が必要か、どこで行うかを尋ねてください。文体の評価だけを求めてはいけません。作者の説明がなければ答えられないなら、不足を記事自体に補います。

次に、機能を受け取っていないアカウントの視点から情報を確認します。その人は自分の状況を見分けられるでしょうか。以前のエクスポートを使い続けられると分かるでしょうか。これは提案する受け入れ確認です。推測なしに両方の範囲を再現できるよう、新機能のあるアカウントとないアカウントの結果を分けて残します。

Aeneia Design のサービス紹介では、このような変更履歴もサービス内のコミュニケーションと体験を設計する一部です。Półka のよい記事なら、「改善された」が「自分のテンプレートとも互換性がある」を意味するのか推測せず、適切なファイルを準備できます。更新はチームを喜ばせるかもしれません。受け手の次の行動も、しやすくするべきです。

Aeneia / Aeneia編集部

編集部による記事です。本文中に出典へのリンクがあります。

Aeneiaについて

ご一緒したブランド

  • L’Oréal
  • Garnier
  • Netflix
  • Carrefour
  • Warner Bros. Discovery
  • Biedronka
  • HBO Max
  • Wolt
  • Żabka
  • COSRX
  • 在ポーランド中国大使館
  • Mixa
Aeneia / Initium

知識から決断へ

整理したい課題をお聞かせください。どこから始めるかを一緒に決めます。

Aeneiaに問い合わせる

パートナーのソリューションを活用しています

  • Google
  • OpenAI
  • Microsoft
  • Stripe
  • Anthropic
  • Linear