为保障文档和代码的一致性,文档亦需要通过版本控制管理。但是对于 World 文档这样的二进制文档,几乎所有的版本控制系统都只能对其进行最简单的备份式的版本控制,而不能进行增量式的版本控制和版本之间的差异比较。对于一个10M大小的文档,如果向版本控制服务器提交了20次,则服务器端的空间占用约为 200M。因此如果使用版本控制系统管理文档,不能频繁 Checkin,只用来保存里程碑式的文档,而且不能进行团队的协作。
DocBook 格式的文档是文本格式的文档,这种文档最适合于使用版本控制服务器,如本文档就是在版本控制服务器下的DocBook格式的文档。但问题是,学习使用 DocBook 需要化非常大的精力,我不奢望大家都来用。
对于二进制文档,如果使用文件服务器来管理,则涉及到权限控制、备份策略、版本控制。
文档的管理策略:
里程碑式的文档,交由版本控制系统维护。文件的提交由配置管理组维护,一般只保留里程碑版本;
文件服务器用于日常的文档维护。文档分门别类放在项目目录中;
并且一个文档建立一个目录,文档的多个版本通过文件名体现;
Copyright © 2006 WorldHello 开放文档之源 计划 |