怎樣才算寫了一份好的產品說明書？

產品說明書的用戶似乎總分為兩派，一派會在使用新產品前逐頁仔細閱讀整本使用說明書，另一派寧愿憑自己的直覺組裝宜家家居，也不會瞅一眼說明書。Anyway，說明書也總會有用得著的時候。

你生活的方方面面，背后都有本說明書。

你可能覺得，說明書不過是包裝袋里調出來的一本小冊子而已。其實不然，說明書不僅形式多樣，甚至它還不是現代產物，它們已經存在了至少兩個世紀。

說明書不僅是本實用的指導手冊，它還能披露當時的時代和社會面貌，說明書的演變過程也揭示了消費者的演變軌跡。手冊借助用戶的能力來彌補機器的不足，因此它可反映出當時機器和人的情況。

一、基本原則

工業時代最早的一份使用說明是工程師瓦特（James Watt）制造的一部機器的說明，但不是蒸汽機，而是辦公用復印機。瓦特發現他經常需要制作信件副本，于是發明了一部機器，將墨跡還未干的信紙復印到另一張紙上，制成一個副本。

產品說明簡單明了：取一張紙，放到另一張紙上，將原稿放在上面，通過滾筒。

2009 年 BBC 的一部紀錄片《如何撰寫說明書》里就提到：瓦特非常務實，所以使用說明不是本小冊子，而是貼在機器上的一張紙，這樣你就不會弄丟了，現在的制造商也該好好效仿。

這個小故事其實已經體現了一本好的說明書的基本原則：

不過并非所有說明書都是瓦特的這種形式。

現在的制造商們開始將使用說明附著在產品上，譬如：在發電機側面貼上寫有使用說明的大標簽，或是在發電機的控制板上設置一個彈出式的幫助文件。

另一個早期說明書的范例屬于一款早期相機，柯達 Box Brownie。

除了詳細介紹相機操作方法外，這本說明書還講解了如何拍攝優秀照片，包括如何捕捉最佳人像、如何考慮天氣因素影響（艷陽天、陰云天），甚至室內墻壁顏色的明暗等。

現代品牌哈里剃須刀也采用了同樣方法，不止告訴顧客如何使用產品，還說明了如何獲得最佳效果——對哈里剃須刀而言是完美剃須的小秘方。

通過說明書建立更個人化的聯系很有商業意義。消費者如果對產品感覺良好，日后對該品牌會更有購買傾向。

有些說明書完全摒棄了文字，譬如：瑞典家具巨頭宜家。有些人認為宜家這種無文字說明令組裝家具非常簡單，有些則被那些象形圖搞得暈頭轉向。但至少，圖片說明幫公司節省了文字翻譯成本。

宜家的說明書獲得了國際認可，2015 年贏得保羅?米森納設計功能組別大獎（Paul Mijksenaar Design for Function Award）。

該獎項的策劃人視覺設計專家米森納（Paul Mijksenaar）這樣評價：

宜家創造了一套無與倫比、風格一致、精美絕倫的說明書作品集，不僅辨識度高，而且 30多年來都證明實用有效。

那我們為何有時看不明白宜家說明書呢？

并不是因為說明書不好，而是產品設計得太復雜。宜家的說明書都是以產品為基礎，最不受歡迎的說明書是因為該產品本身設計有不足。宜家說明書采用黑白平面插圖的做法也促使產品本身提升設計質量，務求能簡便組裝。

宜家獲獎的說明書完全不使用文字

不過現在，機器的能力已經大大提升，用戶不太需要說明也能使用，而且很多說明也能在真正使用時由機器提供。很多產品沒有說明書，有些是因為設計優良完全不需要，有些則是因為不允許。譬如 iPhone 就專門設計得難以維修。

說明書短期內不會消失的一個原因是它目前必須包含健康及安全指引，有些用戶覺得這些指引非常多余，但它們體現了制造商對用戶使用產品時的安全負責。另一個影響說明書演變的因素是全球化，公司需要將產品運送至世界各地，有時需要將說明翻譯成幾十種語言，稍有不慎就會給用戶造成疑惑和困擾，有損品牌形象。

消費者使用說明書的方式也發生了改變，過往說明書只是依附于產品的參考指南，但現在人們會在購買前閱讀說明書了解產品的技術性能，因此說明書進入到購買的環節。

近年來網站科技還讓用戶可以自行創建并分享使用說明，譬如：Ifixit.com?就是個“任何人都可以參與編寫維修任何東西的免費指南”。

數據庫和 XML 標記語言（可由人自定義并被計算機理解的標記符號）已經廣泛用于說明書的模塊式編寫和管理當中，也可以使用二維碼來快速獲取相關說明。

AI、AR、VR 等技術也開始被采用，AI 可以預測用戶遇到的問題，更快找到相關信息。隨著人工智能逐步理解用戶行為，它很可能會廣泛取代計算機元數據和卷標。AR、VR 可以將說明層次化，用戶可以在學習使用產品的同時與它互動。

無論使用說明未來是什么樣子，它應該都不會消失，人們在購買復雜產品時的基本需求沒有改變，產品本身與用戶預期也總會有差別，需要說明填補。

其實我想表達的是，大家在寫代碼的時候，也請好好寫注釋

本文為@運營喵原創，運營喵專欄作者。