本文大纲

《我的敏捷软件项目管理实践》

论保持文档的生命力

第九章 团队工具 / Wiki建立团队知识库

论保持文档的生命力

技术团队内最重要的两个方面: 人和知识 。现在可通过Wiki来管理好知识,为文档赋予生命力。

文档的生命力是指,在一个很长的时间段内(一年),有多人来不断的维护更新文档,使它保持最新,跟得上团队的发展,跟得上产品的变化。文档总能保持跟进,更多的人就愿意相信文档。

文档管理较常用的方案有:SVN\FTP等,采用SVN\FTP来管理文档,文档的生命力从作者创建文档时开始,到文档被放入SVN\FTP后,生命基本变结束了就不再活跃了,生命期较短。

虽然阅读者可以通过SVN\FTP把文档下载走并阅读,但基本不会修改文档并上传。就算有少量的阅读者修改文档并上传到了服务器,可原作者也不知道,还会和原作者的本地修改产生冲突。

为了避免这个冲突,阅读者避免修改文档并上传,这样产生了恶性循环。没有多人协同维护文档,文档生命力大大减弱了。

WIKI相比于SVN\FTP,不但解决了存储、共享,还能让多人协作,让文档有更长的生命力。这是WIKI最大的优势。

比较项 Svn、FTP wiki
存放方式 存储在磁盘或目录中,无自动备份 统一存放在wiki服务端,每天自动备份
访问方式 安装客户端,要求高 访问网站,使用浏览器,要求低
用户管理 基本svn ftp的用户权限管理,较复杂 用户与组的管理,权限细化
操作简便 需要使用svn客户端 在线编辑,支持表格,支持画图
跟踪文档变化 可实现版本管理,但比较不出文档的变化 可实现版本管理,可看到文档的变化,还会发出邮件通知作者变化的部分

结论

wiki在团队协作、保持文档的生命力 方面,可满足团队要求。