寫好一份文件
10/02/2009, 16:00 - 想到的
經常需要讀一些說明文件，發現好的文件很少，要舉例的話，我只想到 Cisco IOS Configuration Guide 和 Apple Developer Library，這兩者的文件在例子及詳細說明，完完整整都會放在同一份文件中，不需要再參考別的文件，而所需要的答案都可以在看過一至兩份文件之後得到，進而還可以完整了解整個工作的方法及流程。但是其他很多公司的文件就沒有這麼好了，這些文件大都需要參照來參照去的，不在同一份文件中詳細說明，而是用了大量的參考連結，通常的結果就是看了半天，連來連去，結果不知所云。像Microsoft MSDN的文件就是這樣。不直接給答案，而是用連結回答問題，結果弔發更多問題。
不過像Cisco和Apple，也因為將所有的資料都放在一起，並詳細說明，所以文件一般都比較大，但大都可以解決讀者的問題，而且因為太大，所以都提供可下載的版本，拿回去慢慢看。而Microsoft分成無數個小檔案的文件，就是每個文件只有寫一部份，再用連結連起來，其他的請參考某編號文件，經常在轉了一大圈之後回到原點，而問題還是沒有解決，而且因為檔案內容太少，大都沒有提供可下載的版本，不然就是需要拿一堆檔案，自已再從中看看可不可以找到答案。
有一個問題可以找到很多不同的版本，但是以 Cisco 和 Apple 而言，大都會有新舊版本之間的說明可看。而Microsoft的話，就只有看當時的運氣，以及個人的修為而定了。
Open Source 的話，我認為 GNU Project的文件算是很好的，而wxWidget 的也不錯，不過像Qt,GTK+,GNOME及X.org,都太分散了,就很不好。
所以就創造了很多人,利用這些寫得不好的文件,而自己再寫一份來賣錢!
chiahsien
10/03/2009, 08:09
確實如此～我也用過 MSDN 數次，一整個被牽到不知名的地方，起初沒有經驗還會搞不清楚自己要問什麼，而從頭再開始。
還有一個現象是同一個問題，在 Microsoft 裡面有數個站有數個參考文件，這個經驗的時間點發生在 XP SP2 釋出後，SP3 即將釋出，繞很久才找出 IT 人員的肥大版。
或許我是個案，有很多伙伴們不會，畢竟我也不是經常逛 MIcrosoft，相較之下，在 Apple 裡面，所有釋出的升級套件，一搜就很集中火力地秀在使用者面前。
再說 Microsoft 的網站也常讓我無從著手，改版後是有好一些。
不禁又想要買顆蘋果來吃了…
Tasuka
10/05/2009, 09:17
可能轉圈圈是M$的傳統吧,使用Windows Help 也是一樣不知所云,而"請找程式開發人員"之類的錯誤訊息就更不用說了...真是令人無言!回應
