所謂”知識管理與知識積累”，其實有點繞，我們不如就說說”運維技術文檔”的事兒吧，這樣可能還直白一點。因為每次說起類似的話題，總有兄弟用不屑的語氣說，不就是寫寫文檔的事兒么?
運維友好的文檔
不同的團隊對文檔要求可能都有不同的”風格”–更多的時候是運維主管要看著舒服。就運維來說，必須能夠創建”運維人員友好”的文檔。
一般來說，運維文檔應該具備如下特點：
- 易讀性 便于閱讀，便于技術人員閱讀。尤其是內容不應引起歧義、轉碼等。
- 可搜索性 針對具體內容便于查找，便于發現。
- 版本化控制 這里不是普通的 V1.0，V2.0 之類的簡單標識版本，而是要能夠獲取所有的內容改變過程，便于回溯。
- 通行格式 能夠適應不同的操作系統平臺。
- 信息完備性 具備足夠豐富的交叉引用，反復保存的時候不會丟失信息等。
可能還有其他特性沒在這里一一列出。有的網友看了上面的描述，這不就是 Wiki 嘛! Bingo! 基于HTML 的 Wiki 頁面，絕對是對運維友好的，尤其是網站運維團隊。 我見過很多團隊用 Word 寫文檔，這是非常糟糕的事情。在版本化控制、可搜索性方面具備天生缺陷。或許書寫運維報告用 Word 是好的選擇，但是運維技術文檔的積累絕對不能用 Word。
運維友好的 Wiki
你們的運維團隊在用 Wiki 么?
一般來說，具備一頂的語言背景可能更喜歡用該語言開發的工具(嗯，我說的是”一般”)，有一定 Java 背景的程序員可能會喜歡用 Confluence 之類的 Wiki 工具。而對運維人員來說呢，什么是他們的語言背景? Shell ? No ! Perl/Python/PHP ，一般運維人員可能都熟悉三者之中的東西。
我個人多少喜歡一點 TWiki ，盡管我對 Perl 不那么熟悉。而很多中小 Web 網站，可能是 PHP 為開發語言，摟柴火打兔子，捎帶腳讓程序員幫著定制一些功能就成了。這是不是有點扯遠了? 什么是運維友好的 Wiki 呢? 我的意見是要能促進運維人員技能的 Wiki 軟件，比如選用了 TWiki，那么在維護的時候，Perl 背景技能就能派上用場并能進一步促進，多少有點以戰養戰的意味在里面。
此外，應該強制運維人員提交 Wiki 標記化的文檔，而不是簡單上傳一些 Word 文檔、PPT 甚至 HTML附件。Wiki 編輯器里別直接粘貼從 Word 文檔 Copy 來得內容。
如果團隊足夠大，應該有人專門定期檢查文檔質量，乃至對新人做一些簡單的示例或者培訓什么的。寫一份好的文檔甚至比寫一大段好的代碼更重要。
知識管理與積累
Wiki 上都記錄什么? 最佳實踐、技術心得、配置文檔、軟硬件信息 … 乃至團隊人員聯系方式，隨時記錄是需要的，但保持更新更重要。
知識管理(KM, Knowledge Management)是干啥的? 這四個字說來話長，維基百科解釋道：
... comprises a range of practices used in an organisation to identify, create, represent, distribute and enable adoption of insights and experiences.
用我的土話說，要把信息沉淀下來并傳遞給更多的人用。一個人寫的文檔，團隊其他的人要能看明白，要理解，要能拿著這文檔做事情。沒有知識管理意識的團隊，成員之間的信息交流或許也有些不順暢，可能會在人員的使用上存在很多瓶頸，遇到一點技術上的小事情，原來負責的人不在場，其他人可能搞不定，這是風險！
有些團隊對待知識管理的態度上是”拿來主義”但缺乏分享精神，比如復制大量網絡上的信息到內部，但是不愿意對外分享團隊的心得，這樣不好!
積累，意味著這是一件長期的事情。不是一窩蜂搞一下就結束不管的。一份運維文檔應該貫穿網站建設的始終，逐漸豐富完善。
