牛腩新闻发布系统——文档是前进的指明灯

      之前在学习软件工程的时，在没有项目经验的前提下进行文档设计，听的是糊里糊涂，在做了【机房收费系统】之后再次进行文档设计，因为只是个人开发，只是为了实现而实现，对于文档的重要性没有很深的体会，现在到了【新闻发布系统】完成了三分之二的时候，深刻体会到了软件开发的前期工作文档是万万不能少的。

      技术、周边组织机构、行业传统等若干因素凑在一起，定义了项目必须准备的一些文书工作。对于一个刚从技术人员中任命的项目经理来说，这简直是一件彻头彻尾令人生厌的事情，但是如果没有认识到这些文档的某些部分包含和表达了一些管理方面的工作，每份文档的准备工作不是集中考虑，并没有使各种讨论意见明朗化，项目往往会处于无休止的混乱状态。

      Frederick P. Brooks根据自身的工作经验在《人月神话》这一本书中也谈到了文档的重要性，可以归结为三点：

                  

 

结合高校云平台v2.0说明文档的意义：

1.提高软件开发的能见度。把开发过程中发生的事件记录在文档中，负责人通过这些文档作为检查软件开发进度和开发质量的依据，实现对软件开发的工程管理。

2.提高开发效率。文档驱动型的开发，使得开发人员对于各个阶段的开发情况、出现的问题、解决的方法都了然于胸，避免在相同的问题上花费过多的时间。可以通过周密思考、整体权衡，从而减少返工。

3.是开发人员在一定阶段工作成果和结束的标志。

4.记录开发过程的有关信息，便于以后系统的使用和运维，有利于各个版本直接进行交接，给以后相似的软件开发提供借鉴经验。

5.便于负责人、开发人员、操作员、测试人员、用户之间的协作和交流。

对于【牛腩新闻发布系统】的文档，尽管是个人开发，但是文档的书写依然重要。从编写设计说明书中对之前所学的SQL语句进一步巩固，在后期进行前台设计和后台开发时，对于文档中数据库设计图、系统功能图、界面模拟图以及数据表类操作方法等一直都离不开文档的指导。

【总结】软件已从传统的开发方式发展到工业化的生产方式，文档在开发的过程中起到了关键性作用，它是软件开发的规范和指明灯，文档的跟踪维护是项目监督和预警的机制，其本身可以作为检查列表、状态控制，也可以作为汇报的数据基础，应该把文档看做一个友好的工具，尤其是对于项目经理来说。写文档就像写历史著作一样，回顾过去、立足现在、展望未来，记录下所发生的事情。