本文大纲
《我的敏捷软件项目管理实践》
论保持文档的生命力
论保持文档的生命力
技术团队内最重要的两个方面: 人和知识 。现在可通过Wiki来管理好知识,为文档赋予生命力。
文档的生命力是指,在一个很长的时间段内(一年),有多人来不断的维护更新文档,使它保持最新,跟得上团队的发展,跟得上产品的变化。文档总能保持跟进,更多的人就愿意相信文档。
文档管理较常用的方案有:SVN\FTP等,采用SVN\FTP来管理文档,文档的生命力从作者创建文档时开始,到文档被放入SVN\FTP后,生命基本变结束了就不再活跃了,生命期较短。
虽然阅读者可以通过SVN\FTP把文档下载走并阅读,但基本不会修改文档并上传。就算有少量的阅读者修改文档并上传到了服务器,可原作者也不知道,还会和原作者的本地修改产生冲突。
为了避免这个冲突,阅读者避免修改文档并上传,这样产生了恶性循环。没有多人协同维护文档,文档生命力大大减弱了。
WIKI相比于SVN\FTP,不但解决了存储、共享,还能让多人协作,让文档有更长的生命力。这是WIKI最大的优势。
| 比较项 | Svn、FTP | wiki |
|---|---|---|
| 存放方式 | 存储在磁盘或目录中,无自动备份 | 统一存放在wiki服务端,每天自动备份 |
| 访问方式 | 安装客户端,要求高 | 访问网站,使用浏览器,要求低 |
| 用户管理 | 基本svn ftp的用户权限管理,较复杂 | 用户与组的管理,权限细化 |
| 操作简便 | 需要使用svn客户端 | 在线编辑,支持表格,支持画图 |
| 跟踪文档变化 | 可实现版本管理,但比较不出文档的变化 | 可实现版本管理,可看到文档的变化,还会发出邮件通知作者变化的部分 |
结论
wiki在团队协作、保持文档的生命力 方面,可满足团队要求。