動画かドキュメントか：録画すべきときと書くべきとき

どのチームもいずれ同じ議論にぶつかります。誰かが「短い動画を撮ればいい」と言い、別の誰かが「これはドキュメントにすべきだ」と言う。そして結論が出るまでの一週間、そのタスクは誰にも手をつけられないまま放置されます。

答えはどちらか一方が優れているということではありません。動画とテキストは、それぞれ別の場所で失敗するのです。動画は動き・順序・判断を見せることにかけては圧倒的です。テキストは、ざっと読む・検索する・修正することにかけては圧倒的です。選択を誤ると、2行で済む答えを8分の録画の中に埋めてしまうか、ドラッグ＆ドロップの操作を文章で説明するのに午後を丸ごと使うことになります。

このガイドでは、着手する前に30秒で判断できる、再現性のある基準を紹介します。

30秒の判断テスト

ドキュメント化しようとしている対象について、3つの質問をしてください。

1. それは動きますか？ 理解するために何かが起きるのを見る必要があるなら——カーソルの軌跡、状態の遷移、アニメーション、リアルタイムに反応するツール——録画しましょう。
2. 後から特定の一部分だけが必要になりますか？ ある値、フラグ、手順ひとつを確認しに戻ってくる内容なら、書きましょう。ポート番号ひとつのためにタイムラインをスクラブする人はいません。
3. どのくらいの頻度で変わりますか？ 画面が毎月変わるなら、テキストのほうが維持コストは安く済みます。1年間安定しているなら、動画は十分に元が取れます。

「動画」の答えが2つなら録画。「テキスト」が2つなら執筆。半々なら、おそらく両方が必要です。これは思うほど大変ではなく、後ほど説明します。

動画が勝つとき

複数のツールをまたぐワークフロー。 ほとんどのプロセスで難しいのは個々のクリックではなく、アプリケーションの間で何が起きるかです。録画なら、6回のコンテキスト切り替えを説明しなくても全体の道筋を捉えられます。

視覚的な判断が絡むもの。 「余白のバランスをもう少し」「このアニメーションは速すぎる」「グラフにもっと余裕を」。テキストで正確に指定するのは不可能ですが、動画10秒なら一目瞭然です。

バグ報告と再現手順。 録画は正確な順序、正確なタイミング、正確な状態を示します。「こちらでは再現しません」というやりとりを丸ごと消し去ります。

オンボーディングと第一印象。 新しいメンバーには、熟練とはどういうものかを見せる必要があります。この作業がどれくらいの速さで終わるべきか、経験者がどこで一瞬止まるか、何を無視するか。文章化された手順はそれらをすべて平坦にしてしまいます。

3回以上口頭で説明することになる内容。 同じ話を3つの会議でしたなら、必要なのは4回目の会議ではなく録画です。

ニュアンスを伝えたいとき。 フィードバック、微妙な判断を含む決定、そっけなく読まれかねない内容は、声と顔がついているほうがずっとよく伝わります。

テキストが勝つとき

リファレンス資料。 設定値、APIパラメータ、キーボードショートカット、エラーコード。学ぶのではなく調べるもの全般です。

検索できる必要があるもの。 テキストは社内wiki、ヘルプセンター、検索エンジンにインデックスされます。動画は字幕を付けない限りブラックボックスです。

頻繁に変わる手順。 ドキュメントの1行を直すのは数秒です。区間を録り直し、音声を合わせ、再書き出しするには1時間かかります。そして古くなった画面のひとつひとつが、ライブラリ全体の信頼を削っていきます。

作業をしながら見る内容。 片手でマイグレーションを実行しながら、もう片方の手で動画を一時停止して巻き戻したい人はいません。チェックリストは読むためのものです。

法務・コンプライアンス、正確な文言が必要なもの。 分かりやすさより正確さが重要なら、書いて、レビューして、バージョン管理しましょう。

翻訳が多いコンテンツ。 テキストは14言語へ安価に翻訳できます。ナレーションの録り直しはそうはいきません。

実際に多くのチームが必要とする形式

最良のドキュメントは、どちらか一方であることはまれです。テキストという背骨に短い動画を添えた形です。

うまくいくパターン：

• 信頼できる情報源としてのテキストページ。 タイトル、目的、前提条件、番号付きの手順、そしてコピーできるテキストで書かれた正確な値。
• 上部に埋め込んだ2〜4分の録画。 これから何をするのか、その全体像を読者に伝えます。
• チャプターマーカーとタイムスタンプ。 動画が線形ではなく、たどれる資料になります。
• 文字起こしまたは字幕。 動画の内容が検索可能になり、アクセシビリティも確保されます。

要点を知りたい人は見る。値を知りたい人は読む。どちらを選んでも損をしません。

動画は短く。それが鮮度を保ちます

動画ドキュメントが腐る最大の理由は長さです。8つのトピックを含む20分の録画は、ひとつのトピックが変わるだけで丸ごと作り直しになります。3分の動画が8本なら、ひとつずつ差し替えられます。

動画ライブラリを維持可能に保つ実践的なルール：

• 1本の動画に1つの成果。 タイトルに「〜と〜」が必要なら分割しましょう。
• 5分未満を目安に。 ほとんどのプロセス説明は3分に収まります。
• 最も変わりやすい部分は録画しない。 価格、日付、チーム名、UI文言は動画の隣のテキストに置きましょう。
• バージョンを口に出すか、画面に表示する。 「バージョン4.2で録画しています」の一言が、「古い動画」を「時点が明示された動画」に変えます。ダメージははるかに小さくなります。
• きれいに録る。 通知オフ、実顧客データではなくデモデータ、一貫したテーマ。3か所で再利用できる1本は、再利用できない3本より価値があります。

録画のコストを下げる

「やっぱり書こう」という判断の多くは、実は「録画は一大制作に感じる」という意味です。そのコストを下げれば、チーム全体の計算が変わります。

• イントロを飛ばす。 大事な画面から始めましょう。社内ドキュメントに15秒の前置きは誰も必要としていません。
• 一語一句の台本を書かない。 箇条書きを5つ書いて、それを見ながら話しましょう。台本は読んでいる感じを生み、準備時間を3倍にします。
• 録り直しではなくカットで直す。 無音、言い間違えた文、長いロード時間を削りましょう。ほとんどのテイクは救えます。
• 説明よりズームを使う。 クリックしたボタンへのズームは、その位置を説明する一文の代わりになります。
• 良いテイクが1本取れたら終わりにする。 社内ドキュメントに4回目の挑戦は不要です。そのまま出しましょう。

シンプルなチームルール

この議論を終わらせたいなら、4行だけ書き留めてください。

1. リファレンスと設定 → テキスト。 常に。
2. ワークフロー、デモ、フィードバック → 動画。 5分未満で。
3. 作業中に使うもの → テキストのチェックリスト。 動画の概要は任意。
4. 四半期より頻繁に変わるもの → テキスト。 ただし視覚そのものが本質の場合は除く。

そして、他の4つより大事なルールをひとつ加えましょう。すべての動画に、テキストのタイトル、一文の要約、関連ドキュメントからのリンクを付ける。 誰にも見つけられない録画は、存在しなかった録画と同じです。

おわりに

形式を選ぶことは好みの問題ではありません。半年後にあなたの成果物を読むすべての人に代わって下す、保守の意思決定です。動画は理解を買い、テキストは持続性を買います。最高のドキュメントを持つチームは、どちらかの側についたチームではありません。議論をやめ、見る価値のあるものは録画し、調べる価値のあるものは書き留め、その2つをつないだチームです。