When life gives you lemons, write better error messages
似乎很少看到有文章認真地探討,該如何適當地撰寫軟體系統中的錯誤訊息。來自 Wix UX 團隊的文章《When life gives you lemons, write better error messages》,描述了 Wix 網站平台如何對錯誤訊息的表達做出檢討,擬定新的原則,並投注心力加以改善。
這是一篇很值得一讀的文章,雖然當中的概念,主要是針對一般用戶,可能不一定都適用在不同的情境中。比方說在微軟產品裡,經常是僅僅丟出一長串的錯誤代碼,讓使用者自己按代碼去搜尋解答。儘管這確實應該是有改善空間,不過採用錯誤代碼的方式,背後應該也是有其工程考量。而非蓄意的怠惰,然後把麻煩轉嫁在使用者身上。
在 DR 的觀念裡,倘若不知道錯誤訊息該怎麼寫,那麼最至少就是單純地把事實陳述出來。說明發生了什麼事,以及根據程式的設計邏輯,盡可能準確表達出問題的來源。