影片還是文件：什麼時候該錄影，什麼時候該寫字

每個團隊最後都會遇到同一場爭論。有人說「隨手錄段短片就好」，另一個人說「這應該寫成文件」，然後這件事就擱置了一週，雙方都在等一個結論。

答案不是哪一種格式比較好，而是影片和文字會在不同的地方失效。要呈現動作、順序和判斷，影片無可取代；要方便掃讀、搜尋和修改，文字無可取代。選錯了，你要嘛把兩行就能講完的答案埋進八分鐘的錄影裡，要嘛花一個下午用文字描述一個拖放動作。

這篇指南提供一套可重複使用的判斷方法——在動手之前，大約三十秒就能得出結論。

三十秒判斷法

針對你要記錄的內容，問三個問題。

1. 它會動嗎？ 如果理解它需要看著某件事發生——游標軌跡、狀態切換、動畫、工具的即時反應——那就錄下來。
2. 之後有人會只需要其中某一項嗎？ 如果人們會回來查某個特定的值、選項或步驟，那就寫下來。沒有人會為了找一個連接埠號碼去拖動時間軸。
3. 它多久變一次？ 如果畫面每個月都在變，文字的維護成本更低。如果它一年都穩定，影片就值回票價。

兩個答案指向「影片」就錄製，兩個指向「文字」就撰寫。如果各占一半，你多半兩者都需要——這比聽起來容易，下面會談到。

影片勝出的情境

跨工具的工作流程。 大多數流程的難處不在於某一次點擊，而在於應用程式之間發生了什麼。錄影能完整捕捉整條路徑，你不必去描述六次情境切換。

任何牽涉視覺判斷的事。 「間距再平衡一點」「這個動畫太快了」「圖表要更有呼吸感」。這些用文字無法精確指定，用十秒影片卻一目了然。

錯誤回報與重現。 錄影呈現了確切的順序、確切的時機和確切的狀態，直接終結「我這邊重現不了」的來回拉扯。

新人上手與第一印象。 新同事需要看到「熟練」是什麼樣子——一項任務應該多快完成、有經驗的人在哪裡會停頓、他們會忽略什麼。文字步驟會把這些全都抹平。

你本來要口頭講三遍的內容。 如果同一件事你在三場會議上都講過，那需要的是一段錄影，而不是第四場會議。

傳達語氣。 回饋、帶有分寸的決定，以及任何可能被讀成生硬的內容，配上聲音和臉孔都會更容易被接受。

文字勝出的情境

參考資料。 設定值、API 參數、快速鍵、錯誤代碼。所有用來查而不是用來學的東西。

必須可搜尋的內容。 文字會被你的 wiki、說明中心和搜尋引擎建立索引。除非加上字幕，影片就是一個黑盒子。

經常變動的步驟。 改文件裡的一行只要幾秒。重錄一段、對齊音訊、重新匯出要花一小時——而每一格過時的畫面都在削弱整個資料庫的可信度。

需要邊做邊看的內容。 沒有人願意一隻手跑遷移腳本，另一隻手暫停、倒轉、再播放影片。檢查清單是拿來讀的。

法務、法遵以及任何需要精確措辭的內容。 如果精確比清晰更重要，就寫下來、審閱、做版本管理。

需要大量翻譯的內容。 文字翻成十四種語言成本很低，重新錄製旁白則不然。

多數團隊真正需要的格式

最好的文件很少是二選一，而是一段短影片配上文字的骨架。

一個可靠的模式：

• 以文字頁面作為唯一事實來源。 標題、目的、前置條件、編號步驟，以及可複製的精確數值。
• 在靠上位置嵌入一段兩到四分鐘的錄影。 它展示這項任務的整體輪廓，讓讀者知道自己將要做什麼。
• 章節標記和時間戳記。 讓影片從線性內容變成可導覽的資料。
• 逐字稿或字幕。 讓影片內容變得可搜尋，也更具無障礙性。

需要整體概念的人去看，需要具體數值的人去掃。兩類讀者都不會因為對方選了另一種格式而受罰。

讓錄影夠短，它才能長期有效

影片文件失效的頭號原因是長度。一段涵蓋八個主題的二十分鐘錄影，只要一個主題變了就得整個重做。八段三分鐘的錄影則可以逐一替換。

讓影片庫保持可維護的實用規則：

• 一支影片，一個結果。 如果標題裡需要「和」，就拆開。
• 控制在五分鐘以內。 大多數流程講解三分鐘就夠。
• 不要錄最容易變的部分。 價格、日期、團隊名稱和介面文案，應該放在影片旁邊的文字裡。
• 把版本說出來，或者放在畫面上。 「本影片錄製於 4.2 版」這一句，能把「過時的影片」變成「有明確時點的影片」，傷害小得多。
• 錄得乾淨。 開啟勿擾模式，用示範資料而不是真實客戶紀錄，維持統一主題。一段能在三處重複使用的素材，勝過三段不能重複使用的素材。

降低錄製的成本

很多「還是寫文件吧」的決定，其實是「錄影感覺像一場製作」。把這個成本降下來，整個團隊的算式就變了。

• 省掉開場。 直接從關鍵畫面開始。內部文件不需要十五秒的鋪陳。
• 不要逐字寫稿。 列五個要點，照著講。逐字稿會讓人聽起來像在唸，還會讓準備時間變成三倍。
• 用剪輯解決問題，而不是重錄。 剪掉空白、說錯的句子和漫長的載入。幾乎每一條素材都還有救。
• 用縮放取代解說。 對著你剛點的按鈕放大，就取代了一句解釋按鈕位置的話。
• 一條合格的素材就夠了。 內部文件不需要第四次嘗試，發出去就好。

一份簡單的團隊規則

如果你想徹底結束這場爭論，寫下四行：

1. 參考與設定 → 文字。 永遠如此。
2. 工作流程、示範與回饋 → 影片。 五分鐘以內。
3. 任務進行中要用的 → 文字清單，影片概覽為選配。
4. 變動頻率高於每季的 → 文字，除非畫面本身就是重點。

然後加上一條比前四條更重要的規則：每段影片都要有文字標題、一句話摘要，以及來自相關文件的連結。 沒人找得到的錄影，等於沒錄過。

結語

選擇格式不是風格偏好，而是你替六個月後閱讀這份內容的每一個人所做的維護決定。影片買來的是理解，文字買來的是耐久。文件做得最好的團隊，不是選邊站的團隊，而是停止爭論、把值得看的錄下來、把值得查的寫下來、並把兩者連接在一起的團隊。