一 背景
1.毕业3年半,从嫌弃软件工程中文档的复杂、繁琐程度,到承认写这些文档才是最快的编写功能程序的方式。感慨一下在郑州大学学习的知识还是非常科学的。
2.软件工程中要求4种以上的文档,使自己和他人进行软件维护时,有抓手,能清楚的知道软件每行代码的功能。
最近也发现,好的文档写完,代码只是将文档种的内容抄写一遍而已,感觉多年重视的代码竟然失去了圣光,变成了手里的工具
二 软件工程文档
1.可行性研究
前置条件
分析软件编写需要的条件。对前置条件进行挑选和测试。
风险分析
是否能实现功能,时间成本,空间成本,对其他功能的影响。
2.需求分析
要多次询问,要比需求方更懂需求方的需求。
了解想过业务
敲定需求后,要在合同中确定需求返工、更改、增加要额外付给我们的报酬(也可以在提需求的时候声明,避免需求的随意变更带来的麻烦)
3.总体设计
4.详细设计
5.实现
编码,安装详细设计编码即可
6.测试
单元测试,集成测试
三 总结和感悟
弯路有时候却是捷径。看起来麻烦的工作,是多年来软件工程的经验结晶,我们用工程的思想,来完成软件的开发。推荐阅读《人月传说》、《软件工程导论》。
水无定形,我们写文档不需要模板,自己怎么舒服怎么写即可(除非有硬性要求,也可以自己私下写自己喜欢形式的文档,明面上将满足公司团队需要的文档提交即可)。拘束在工程文档规范模板中僵直无法动弹,我更喜欢写自己看的懂的模板。自己开心最重要。