開發升訊威在線客服系統啟示錄：怎樣編寫堪比 MSDN 的用戶手冊
- 2022 年 2 月 3 日
- 筆記
本系列文章詳細介紹使用 .net core 和 WPF 開發 升訊威在線客服與營銷系統 的過程。
免費在線使用 & 免費私有化部署：//kf.shengxunwei.com
影片實拍：演示升訊威在線客服系統在網路中斷，直接禁用網卡，拔掉網線的情況下，也不丟消息，不出異常。
//blog.shengxunwei.com/Home/Post/fe432a51-337c-4558-b9e8-347b58cbcd53
不忘初心 方得始終：開源、免費、共享 之精神 ♥
大部分程式設計師都不愛寫文檔，但是為了能讓用戶快速了解產品，提供指引。好的文檔和好的產品一樣重要。
既然說產品要容易使用，為什麼又講到要有完善的文檔和說明書呢。你要為用戶的使用設計一個遞進的層次。往往用戶是在直接體驗，感覺良好之後，才有可能看你的文檔和說明書。所以兩者不矛盾。
用戶根據文檔，就能自己完成系統的搭建，一方面使我能夠積累到更多的用戶，另一方面也減輕了我自己的精力，在有詳細文檔之前，需要花很多時間回答用戶的疑問。
詳細的文檔為我默默積累了許多前期用戶，對於大部分人來說，如果沒有詳細的文檔，他們會直接放棄使用你的產品，而不是來諮詢你，這一點很重要。
我歸納為以下幾點：
- 要有好的在線文檔系統
- 仔細設計文檔結構
- 認真編寫文檔內容
- 認真對待所有用戶的每一個問題
下面我仔細講講我是怎麼做的。
要有好的在線文檔系統
首先我 花了大約 35分鐘 時間，寫了一個在線文檔平台，功能簡單，但是做到了版式簡明，內容展示清晰。
//docs.shengxunwei.com/Post/f7bc8496-14ee-4a53-07b4-08d8e3da6269
仔細設計文檔結構
我仔細設計了文檔的類目結構，一步一步分解了軟體的部署和使用過程。
特別是對於私有化部署的過程，我按 部署新伺服器、升級現有伺服器、伺服器維護 等幾個大類別，分開進行了詳細說明。
在每個大類別下，我又按 Windows、Linux、寶塔、Docker 不同的平台，進一步詳細說明。
認真編寫文檔內容
首先，是簡單易懂，圖文並茂
不搞玄學，不預設用戶是否有經驗。一切從 0 開始講解。每一步都以配圖加文字的方式詳細講解。
其次，是嚴謹認真
對於安裝部署的過程，我新開環境乾淨的伺服器，一邊實際操作，一邊對照寫文檔。寫完之後，釋放伺服器環境再次重置，然後嚴格跟著文檔再次驗證，發現有疏漏的地方就立即補充修改。
認真對待所有用戶的每一個問題
在平時收到用戶的問題，我從來沒有「怎麼這都不會」，「怎麼這都不知道」這類的想法。
不管什麼問題，我都會認真回答，並更新到在線文檔中去。經過一段時間的積累，文檔越來越完善。
收到用戶的熱心回饋
在文檔上線一段時間後，陸續有用戶向我提供積極的回饋。
做為一個程式設計師，還有什麼比這更有成就感的事情呢？
不忘初心 方得始終：開源、免費、共享 之精神
- 可以追蹤正在訪問網站或使用 APP 的所有訪客，收集他們的瀏覽情況，使客服能夠主動出擊，施展話術，促進成單。
- 訪客端在 PC 支援包括 IE8 在內的所有瀏覽器。
- 移動端支援手機瀏覽器、APP、各大平台的公眾號。
- 具備一線專業技術水平，網路中斷，拔掉網線，手機飛行模式，不丟消息。同類軟體可以按影片方式對比測試。
** 優酷影片：//v.youku.com/v_show/id_XNTEwNzQ5Mzg2OA==.html
** bilibili 影片：//www.bilibili.com/video/BV1pK4y1N7UP?t=22
