検証済みウォークスルーとは？定義と、デモとの見分け方

何をもって「検証済み」とするか

4つの要素があり、4つすべてがそろっている必要があります。どれか1つでも欠ければ、その録画はデモです。デモは別物であり、有用性も劣ります。

• 実際の実行。製品は録画しながら操作されています。アニメーションでも、生成でも、スクリーンショットからの再構成でもありません。
• 製品によるエビデンス。結果は、クリックしている画面とは独立して製品が生み出したものと照合されます。たとえば、チェックサムが一致するバケット内のファイル、別の受信箱に届くアラート、復元後に起動するマシンです。
• 失敗を残すこと。うまくいくまでに起きた失敗は、その対処とともに、ログにも動画にも残ります。
• バージョンタグ。実行時のビルドが記録されるため、動画は人知れず古くなるのではなく、そのビルドが変わったときに再実行できます。

該当しないもの

• デモ。答えをすでに知っている人が、リハーサルどおりの手順をなぞるものです。偽りはありませんが、エビデンスではありません。
• 生成された動画。モデルが台本から映像を作ったものです。ソフトウェアが実際に何をするかに一度も制約されていないため、間違えようがなく、したがって何も検証しません。
• ナレーション付きのスライド。概念の説明には便利だが、製品は動いていない。
• 1人に送る画面録画。文脈を共有している1人の相手には適しています。ただし、バージョンも前提条件もエビデンスも含みません。

約1分でデモと見分ける方法

質問は6つです。高額なものも含め、ほとんどのソフトウェア動画は1つか2つにしか答えていません。

• タスクは、特定できる時点で完了していますか？
• 製品のバージョンが明記されていますか？
• 何かをクリックする前に、前提条件が画面に示されていますか？
• ナレーターが成功を主張するのではなく、製品が生み出したエビデンスがありますか？
• 何かがうまくいかない様子が映っていますか？
• 視聴者がそのまま行動に移せますか？動画の横に、文章で書かれた手順はありますか？

9項目の公開前チェックの全体はソフトウェアの優れたマーケティング動画の条件で、2つの失敗をそのまま残した実例はProxmox VE 9.2のインストールウォークスルーで紹介しています。

失敗が重要な理由

人は「Xの設定方法」で検索するわけではありません。検索するのは、エラー文字列、うまくいかなかった手順、誰も文書化していなかった設定です。失敗と対処を含むウォークスルーは、その検索に答えます。洗練されたデモはまったく答えないため、答えは結局フォーラムに載ることになります。

よくある質問

検証済みウォークスルーは製品デモと同じですか？

いいえ。デモが示すのは、タスクが実行できるということで、たいていはやり方をすでに知っている人が行います。検証済みウォークスルーが示すのは、明示されたバージョンでタスクが実際に実行されたことです。結果は製品自身のエビデンスと照合され、失敗した試行も見える形で残ります。

誰が検証するのですか？

人間です。AIオペレーターが製品を操作し、人間が結果を製品自身のエビデンスと照合して、公開できるかどうかを判断します。確認されないまま公開されるものはありません。

製品が変わったらどうなりますか？

各ウォークスルーには、実行時のバージョンが記録されています。その製品のリリースが出ると、変更履歴で影響を受けたタスクを再実行します。問題なく再実行できれば再公開され、失敗した場合はログとともにフラグが立てられます。

生成された動画は検証できますか？

いいえ。生成された動画は、ソフトウェアが実際に何をするかに一度も制約されていないため、照合する対象がありません。ほかの場所で検証された事実を正確に解説するものにはなりえますが、製品についてのエビデンスではありません。