動画は、複雑な概念やワークフローをすばやく把握するうえで、ドキュメントを補う有効な手段です。すべてのドキュメントを動画にする必要はありません。意図を持って使います。目標は、元のドキュメントに対して、わかりやすさを高め、認知負荷を下げ、作業完了を助ける場面に動画を使うことです。
次の場合に動画を使います。
- 複雑なワークフローを説明する
- UI 操作を実演する
- オンボーディングや初回利用の負担を減らす
- 抽象的、概念的なトピックをわかりやすくする
次の場合には動画を使いません。
- リファレンス資料(API のフィールド、パラメーター、上限)
- 頻繁に変わる UI や実験的な機能
- テキストのほうが早くスキャンできる内容
- コピー、貼り付け、正確な検索が必要な情報