文档管理的方案着实是项目管理者头疼的问题,对于文档驱动代码还是代码驱动文档,或者是别的方式来完成文档工作都不是一项简单的工作。
再怎么说一个公司是不可能没有一定积累的,如果公司的每一件产品都是从头开始做起的话,不仅效率是个问题,可靠性也会存在问题,积累就在这时候起了作用,把以前可靠的东西拿出来再用在新产品中,让新产品快速上市。个人也会有很多经验的积累,个人的积累都在脑袋中,人在哪里这累积的东西就在哪里。公司不同,公司是由很多人一起组成的个团体,由团体中的每个人一起来完成工作。
那些强大的公司都是基于文档对项目进行管理,什么事都要文档先行,检查设计的正确性也是从文档的评审开始。但是一般的小项目,小公司做不到这一点,需求不明确,经验不足,设计过程要在反复迭代中完成,这样的文档建立起来很辛苦,在项目开始时没有文档,项目结束后也很难再组织人员完成文档的工作,因为项目都已经成功完成,文档就好像不是很重要了,因为可能下个项目又是全新的,建立文档的确是显得没有必要。
其实对于文档驱动代码还是代码驱动文档,两者都没有错。在对待自己的实际问题上,选择怎么样的文档管理手段,没有必要完全按照强势舆论的方法来,但是也不必悲哀小团体的无赖。有钱人有钱的活法,穷人也得活吧。还是那句老话中听,只有适合自己才是最好的。
文档的建立也是不一日之功,它也是一个发展的过程。开始可以等设计稳定之后再用文档加以记录;还可先有一个大概的文档,一边完成设计再一边文档,在coding的时候作下笔记,再把笔记整理成一份文档;等有了一定的经验后,就会形成一定的文档规范,什么问题该用什么话来说,大家都答成的一个共同的议建,文档就可以先行了。
以上是自己对于公司写文档的一些简看法。