vic0320 wrote:
就算他寫了一堆文件，會去看的也只有他自己。那天離開後，叫全公司的人一起看，也看不懂在寫什麼..(恕刪)
所以說：必須假設看的人技術水準很低，要保證淺顯易懂
即便剛從學校出來那種的，也能立刻看得懂。（從課本基礎知識，慢慢往上講解）
當然不可能是從頭教起，把一位學商或文科的，灌輸2~4年的工科資訊知識進去。至少要有基礎。
總不可能說：寫一個說明書，連掃廁所大嬸都要能看懂，那就太強人所難。若有這種天賦，那就去出書賺大錢了，還吃人頭路幹麻。
公司聘新人，也不會聘一位完全不懂的吧。
公司又不是學校，雖可以教，但是至少要有基礎，相關科系的，持有證照的、或有實務經驗的。
如果如你說的那個人寫一堆文件說明書，只有他自己能看懂，那這人表達能力非常差。
是那個人的能力有問題，不是這種作法有問題。
**********************
那什麼叫做淺顯易懂，除了畫圖講解 架構，思路、實際作法...以外。
Q&A 快速排錯，可能也有需要。
STEP by STEP 手把手，一步驟一步驟。
舉例：
Q.假如 RAID 出現錯誤，或磁碟存取出現異常，該如何排除與重建？
A.
STEP.1
登入 SSH，下指令 xxxxxxx
觀看 xxxxx 處，可以得知是哪顆磁碟發生錯誤
STEP.2
請關機（關機前注意事項 XXXXXX)
STEP.3
拆下機殼，移除有問題的硬碟（上有貼紙標籤），插入全新硬碟。
STEP.4
進行重建
開機，下指令 XXXXXXX...$#@$!@#$@!$@!$，
所需時間預估：XXXX
注意事項：XXXXXX
STEP.5
檢查重建之後是否仍有異常，下指令XXXXXXXXX
進行讀寫測試，下指令XXXXXXXX
.......
註：這只是隨便舉例。實務上硬碟有 SMART 監控，會在 MRTG 什麼的，每日觀看就可以發現磁碟異常，或系統會自動 mail 通知管理員。抽拔硬碟也可能在線熱抽拔。
總之，就是把看的人，當成電腦白痴，把所有步驟交代清楚。
即便那個人是草包，照著 STEP by STEP 步驟做，總會吧。如果連這樣都不會，那聘那個人幹麻，智商可能都有問題。
他若以後有空閒，可以去慢慢研究整個系統架構的組成、原理。
不過需要 緊急處理的事件，他新進來沒有頭緒，就可以依照 STEP by STEP 手把手 指示，去立刻排除錯誤。
很多公司設立 SOP 程序（標準作業程序），不是同理。
員工不需要知道原理、也不需要知道為什麼，反正照著 SOP 程序步驟做就對了。
原理和為什麼，以後待公司的時間長了，再去慢慢理解。
