5分の手順が書き込み、フォーマット、公開で2時間になります。それから新しいスタッフがステップ4に到達し、画面を見て、マニュアルが答えるはずだった正確な質問をします。
言葉は正しかった。ただ、読者が見る必要があったものを示すことができなかった。それがビデオが閉じるギャップであり、デフォルトのドキュメントフォーマットが変化している理由です。
このガイドは、録画ボタンを押すことではなく、適切な媒体を選ぶことについてです。ドキュメント作成ワークフローの一部としてのスクリーン録画については、私たちのガイドがキャプチャのプロセスを扱っています。ここでの問いはもっとシンプルです：手順をドキュメント化する必要があるとき、そもそもそれは書き留めるべきものなのか、それとも見せるべきものなのか？
重要なポイント
- ビデオは視覚的、順次的、またはデモンストレーション可能なすべてのドキュメントのデフォルトフォーマットとしてマニュアルを置き換えています。それがトレンディだからではなく、行動を見ることはそれを読むことよりもそれを行うことに近いからです。
- 媒体は3つのことを同時に変えます：理解（翻訳の代わりに見る）、最新性（散文を再編集する代わりに再録画する）、制作コスト（ワークフローのキャプチャは分かかり、書き上げは時間かかります）。
- テキストは読者が一行ずつスキャン、検索、編集する場所でまだ勝ちます：参照資料、ポリシー、決定基準、そして実行するのではなく参照するもの。
- 最も強いドキュメントライブラリは一括変換ではなくブレンドされています。スキルは側を選ぶのではなく、手順ごとに媒体を選ぶことです。
- 未来は「ビデオがテキストを置き換える」ではありません。単一のキャプチャから生成されたビデオ、テキスト、検索可能なトランスクリプトであり、同じ作業が読者が必要とするどんな形にも存在します。
従来のマニュアルとビデオ
書面マニュアルは読者に作成者の思考を逆転させることを求めます。作成者はタスクを実行し、それを文章に変え、テキストを渡します。読者はそれらの文章を、ほとんど同じには見えない画面や機械上の行動に変換し直さなければなりません。
これらの翻訳の一つ一つが意味を漏らします。「右上の設定の歯車をクリック」は明快ですが、歯車が2つあったり、インターフェースが変わったり、読者が別のプランを使っていたりすると、そうではなくなります。
ビデオはその翻訳ステップを取り除きます。読者はカーソルが正しいコントロールに、正しいインターフェースで、正しい順序で着地するのを見ます。指示と行動は同じものです。
これは単なる好みではありません。マルチメディア学習の研究は、人々が言葉だけよりも一致するビジュアルと組み合わせた言葉のときに手順タスクをよりよく学ぶことを一貫して発見しています。多くの手順では、見せることが説明するより優れています。
2番目の利点は時間とともに現れます：メンテナンスです。マニュアルは一文ずつ腐っていきます。ボタンの名前が変わり、ステップが変わり、ドキュメントはほとんど正しいだけの状態になり、読者はどの部分を信頼していいのか分からなくなります。
ビデオも古くなりますが、メンテナンスは異なります。段落を書き直す代わりに、変更された部分を再録画します。チームが録画されたドキュメントを時間とともに管理する方法については、ナレッジマネジメント手法としてのスクリーン録画のガイドをご覧ください。
これはビデオが普遍的に優れているという意味ではありません。手順、つまり誰かが一連の行動を正しく再現するのを助けることを役割とするドキュメントに向いているということです。参照資料、ポリシー、決定基準は依然としてテキストに属します。
ビデオドキュメントの利点
熱意を剥ぎ取ると、ビデオドキュメントのケースはいくつかの具体的で測定可能なものに還元されます。
制作時間を圧縮する
書面SOPで最もコストがかかる部分は考えることではなく、書き起こしです：すでにやり方を知っていることを、順序立てられた曖昧さのない散文に変えることです。実行しながら同じワークフローをキャプチャすれば、そのコストは崩壊します。
ルーティン手順の書き上げが90〜120分かかる一方で、同じ手順の録画は8〜15分で済むことを、私たちは一貫して見てきました。ドキュメントの作成がそれほど安くなると、チームは以前なら誰かの頭の中に残していたものをドキュメント化するようになります。頭の中こそ、ほとんどのプロセス知識が静かに宿り、そして静かに去っていく場所です。
完了率を上げる
30ステップのマニュアルを開いた読者は、この先にかかる労力を素早く無意識に見積もり、しばしばタブを閉じます。2分のクリップは、より小さく、目に見えるコストを設定します。
ビデオエンゲージメントの研究は、ここでのトレードオフについて率直です：注意は短いセグメントでは保たれ、長さが増えると急激に落ちます。これは、1本の長いフィルムよりも多数の短い録画を支持する論拠であって、テキスト全般に対してビデオを支持する論拠ではありません。
そのように使えば、視覚的なSOPは、長い手順が最後まで読まれるよりもはるかに頻繁に最後まで視聴されます。
スキルと言語のギャップを乗り越える
デモンストレーションは、読者がインターフェースについて自分と同じ語彙を持っていると仮定しません。「IDプロバイダーを介して認証する」で止まってしまう人でも、同じ画面をクリックしていくカーソルなら追えます。
スクリーン録画のチュートリアルは、書面の指示が人々を立ち往生させるまさにそのギャップを越えて、手順を運びます。
暗黙の部分をキャプチャする
書面のステップは、書き留めると決めたものを記録します。録画はそれに加えて、ためらい、クリック前のホバー、「ここでエラーが出たら、こうする」といった、専門家が自分でも知っていると気づかずに行っている部分もキャプチャします。
その残留物こそ、デモでは機能する手順と、午前2時に本当に機能する手順との違いです。これが書く代わりに録画してワークフローをドキュメント化することのコアです：番号付きリストには決して入らない知識を保持できるのです。
目標はすべてのマニュアルをビデオに置き換えることではありません。映像として見せる方が速く、信頼できるのも速いものを、書き留めるのをやめることです。
ユースケース
上記の利点は均等に分配されているわけではありません。2種類の作業が、ほぼそれだけで媒体の議論を成立させます。
ソフトウェアのウォークスルー。画面上で起こることは、ほぼ完璧な適合です。なぜなら、ドキュメントの媒体と作業の媒体が同じピクセルだからです。機能ツアー、設定手順、ある値を一つのツールから別のツールへコピーするマルチアプリのワークフロー。
これらは書くのが苦痛で、見れば一目瞭然です。カーソルの軌跡がそのまま指示になります。ここはまたマニュアルが最も速く古くなる場所でもあります。インターフェースは毎週のように変更が出荷されるからです。そして、リデザインで無効になった3文を散文の中から探し回るよりも、40秒のセグメントを撮り直す方が速いのです。
フィールドサービスと機器修理。もう一つの明確なケースは、物理的で画面外のものです：ガスケットをはめる、ケーブルをシャーシに通す、コネクターをはめる4分の1回転と、ねじ山を潰す半回転の違い。トルク、角度、感触は、文章への道のりを生き残りません。
「しっかりするまで締める」は、作成者には一つの意味ですが、5人の技術者には5つの意味になります。実際の動作を映した10秒のクリップが、その議論を終わらせます。手を動かす作業のトレーニング動画は、ここでは気の利いた付け足しではありません。多くの場合、そのタスクが実際にどう行われているかを忠実に記録した唯一のものなのです。
共通する性質に注目してください。どちらも、読者が必要とする情報が事実やルールではなく動きと空間的な関係であるケースです。
手順のペイロードが「これを、この順序で、このように行う」であれば、ビデオはどの段落よりも少ない損失でそれを運びます。ペイロードが「そもそもどういう条件でそれを行うのか」であれば、それはもはや行動を説明しているのではなく、計算は逆転します。
テキストがまだ重要な場合
ここに正直な限界があります。しかも小さな限界ではありません。
ビデオは、まさにテキストが得意なことが不得意であり、それらのことはまれではありません。
ビデオはスキャンできません。半分だけ覚えている一つの条項を、その中から検索することはできません。APIレートリミットに触れている箇所を見つけるために録画をctrl-Fすることはできません。再録画せずに一つの間違った単語を直すことはできませんし、話者が話すより速く読むこともできません。
人が実行するのではなく参照するドキュメントにとって、これらは致命的な弱点です。
ですからテキストは依然として次のものを担います：
- 参照資料。パラメータの表、エラーコードの意味、キーボードショートカット、設定の上限：数秒で調べられ、最初から最後まで視聴されることのないもの。
- ポリシーと決定基準。方法のステップではなく、かどうかといつのルール。「顧客データが露出した場合はsev1にエスカレートする」は一文であり、一文のままであるべきです。
- 行レベルで頻繁に編集されるもの。価格の閾値、コンプライアンス条項、変わる名前。これらは一行の編集が必要であり、一行の編集が一行の編集で済む唯一の媒体はテキストです。
- ビデオライブラリ上のスキャン可能なインデックス。ビデオはその周りにテキストを必要とします。録画は、検索可能なトランスクリプト、タイトル、一行の要約とともにあってこそはるかに有用になります。後で誰かがそれを見つけるのは、そうしたテキストによってだからです。
間違いは、これをビデオの失敗として扱うことです。これは分業です。テキストが適切な媒体であるとき、重要になる技能は別のものです：正確さ、構造、そしてページ上の曖昧さを取り除くこと。その規律については、テキストが適切な媒体であるときに明確な指示を書く方法のガイドをご覧ください。両方の媒体を理解する読者は「ビデオかテキストか」を問うのをやめ、「参照するのか実行するのか」を問い始めます。それこそが、実際に答えを予測する問いなのです。
ベストプラクティス
媒体をうまく選ぶことはスキルであり、いくつかのルールがあれば、どんなツールで録画するかに関係なく再現可能になります。
録画する前に動詞で分類する。手順の中核となる動詞が行う、実行する、クリックする、組み立てる、設定するであれば、ビデオに寄せます。決定する、調べる、比較する、参照するであれば、テキストに寄せます。
実際のほとんどの手順は混合であり、それが本当のパターンを示しています：行動のための短いビデオと、判断のための数行のテキストが、隣り合って置かれるのです。
セグメントは短く、単一目的に保つ。一つの録画は一つの疑問に答えるべきです。オンボーディングフロー全体をカバーする12分のフィルムは、検索性の悪いマニュアルにすぎません。
自然な継ぎ目で分割し、タスクごとに1本のクリップにしましょう。そうすれば各パートは注意が落ちる長さ以下に収まり、隣のパートを撮り直さずに更新できます。
作業をキャプチャし、演出しない。視覚的なSOPの価値は、専門家が本能的に行う小さなリカバリーや付随的な確認を含め、実際のものを示すことにあります。衛生的に作り込んだ再現ではなく、実際のタスクを行っている誰かを録画しましょう。
これが書く代わりに録画してワークフローをドキュメント化することの核心となる考え方です：忠実さこそが要点であり、演出はそれを投げ捨ててしまいます。
すべてのビデオを、見つけられるテキストで包む。各録画に、説明的なタイトル、それが何を教えるかの一行の要約、そしてトランスクリプトを与えましょう。
これはチームがスキップしがちなステップですが、ライブラリが6か月後に使えるものになるか、それとも誰も開かないラベルなしクリップのフォルダになるかを決めるステップです。
両方の媒体を、同じ手順上の厳密さで扱う。フォーマットを変えても、手順を信頼できるものにする要素は変わりません：明確なトリガー、オーナー、定義された「完了」、そしてレビューのサイクル。それらは媒体ではなく手法から生まれます。
録画する場合でも書く場合でも当てはまる基礎的な規律については、あらゆる文書化された手順を支える7ステップのフレームワークをご覧ください。
誰もタイトルを付けなかった録画は、誰も見つけられない録画であり、それは存在しない録画も同然です。
将来のトレンド
興味深い近い将来のシフトは「より多くのビデオ」ではありません。それは選択そのものの崩壊です。
ドキュメントの歴史のほとんどにおいて、媒体は道の分岐点でした。マニュアルを書くかビデオを録画するかを事前に決め、後で切り替えることは最初からやり直すことを意味しました。その分岐点が閉じつつあります。
ワークフローの一度のキャプチャが、ますます複数の出力を同時に生み出すようになっています：見たい人のためのビデオ、ざっと読みたい人のための自動生成されたステップリスト、そして一つの詳細を探している人のための検索可能なトランスクリプト。
読者が形式を選び、作成者は一度だけ録画します。それが当たり前になると、「ビデオかマニュアルか」は決断ではなくなり、レンダリングになります：同じキャプチャされた作業を、その場面が求める形で見せるだけになるのです。
それは媒体をめぐる議論全体を組み替えます。問いは、実のところビデオがテキストを打ち負かすことについてではありませんでした。それは書き起こしの税を終わらせること——既知の作業を散文に変換するために費やす時間——について、そしてインターフェースが動くたびに書き直すことなくドキュメントを最新に保つことについてでした。
キャプチャファーストのツールは、その両方を源で攻略します。それはAIドキュメントが白紙のSOPをどう置き換えるかの背後にあるのと同じシフトです：手順はライターがゼロから書き始めるのではなく、キャプチャされた作業から生まれます。フォーマットの問題を超えてプロセスドキュメントがどこへ向かうのかについては、プロセスドキュメントの行方に関する私たちの考察をご覧ください。
マニュアルは、常にその存在価値を発揮してきた場所——参照、ポリシー、そして他のすべての上に載る検索可能な層——にそのまま残ると予想されます。ビデオは手順のデフォルトのキャプチャ手段になると予想されます。そして2つは、並行して維持する別々の成果物であることをやめ、一つのソースの2つのビューになり始めると予想されます。
習慣ではなく媒体を選ぶ
書面マニュアルは死につつあるのではありません。それはデフォルトからスペシャリストへと降格されているのです。
10年の間、それは唯一手頃な選択肢だったためにあらゆるドキュメントの仕事をこなし、その間ずっと手順の仕事を下手にこなしてきました：読者に散文を行動へと翻訳し直すことを求め、古びた一文ずつ腐っていき、作るのに何時間もかかりました。
ビデオはそれらの手順の仕事を引き受けます。なぜなら、より少ない損失とより少ない労力でそれをこなすからです。一方でテキストは、常により得意としてきた仕事を保ち続けます：私たちが実行するのではなく、参照し、検索し、編集するもの。
ライブラリを変換しないでください。分類してください。各ドキュメントについて、人がそれを何かを知るために読むのか、それとも何かを行うために読むのかを問い、その答えに媒体を選ばせましょう。
この先の数年で勝つチームは、すべてをビデオにしたチームでも、すべてをテキストで守り抜いたチームでもありません。見せる方が速いものを書き留めるのをやめ、調べる方が速いものを撮影するのをやめたチームです。
よくある質問
ビデオドキュメントは書面マニュアルより優れていますか？
手順（人がステップバイステップで実行するタスク）では、ビデオは通常より優れています。なぜなら、読者は文章を行動に翻訳する代わりに行動を見るからです。参照資料や一行ずつスキャン、検索、編集するものには、書面テキストが優れています。正しい質問は読者がドキュメントを参照するか実行するかです。
ビデオドキュメントとは何ですか？
ビデオドキュメントはプロセスを録画としてキャプチャすることです。通常、ソフトウェア作業のスクリーン録画または物理的な作業の映像デモンストレーションであり、読者がその説明を読むのではなくタスクが実行されるのを見ることができます。視覚的なSOP、製品ウォークスルー、トレーニングビデオをカバーします。
企業がマニュアルをビデオに置き換える理由は何ですか？
3つの理由が積み重なります：ワークフローの録画は書き上げが時間かかるところ分かかり、視聴者は長いマニュアルを読むよりはるかに頻繁に短いビデオを最後まで完了し、デモンストレーションは散文が落とす傾向にある暗黙の詳細（順序、タイミング、感触）を運びます。
いつビデオの代わりにテキストを使うべきですか？
読者が何かを調べるのではなく行動するときはいつでもテキストを使います：参照データ、エラーコード、ポリシー、決定基準、そして行レベルで頻繁に編集されるコンテンツ。テキストはスキャン可能で、検索可能で、一語ずつ編集可能です。ビデオにはできないことです。
ビデオとテキストのドキュメントは一緒に機能できますか？
はい、そして最も強いライブラリはそれらをブレンドします。一般的なパターンは、行動のための短いビデオと決定のためのいくつかのテキスト行のペアで、ビデオが検索可能なトランスクリプト付きです。ますます単一のキャプチャがビデオ、ステップリスト、トランスクリプトを同時に生成し、読者がフォームを選びます。
どのようなタスクがビデオで最もよくドキュメント化されますか？
その本質が動きまたは空間的な関係であるもの。画面上のソフトウェアウォークスルー（媒体と作業が同じピクセル）、そして手作業のフィールドサービスや機器修理（トルク、角度、感触が書き留めても生き残らない）の2つが最も明確なケースです。
ドキュメントビデオはどのくらいの長さにすべきですか？
短く単一目的に。一つの録画は一つの質問に答えるべきであり、理想的には2〜3分以内に保ちます。なぜなら視聴者の注意は長さが増えると急激に落ちるからです。長いプロセスを単一のビデオとして撮影するのではなく、タスクごとに一つのクリップに分割します。
