zoukankan      html  css  js  c++  java
  • 架构实战—软件架构设计的过程读后感(二)

    读到第四章,又看到了熟悉的文档编写,哎,头疼,虽说头疼,但文档的编写能力也是考验一个程序员的重要科目,这不是我就在坚持写读书笔记嘛,晚上给自己加个鸡腿。

    所话说,编码10分钟,文档2小时。那为什么在软件开发过程中,文档如此重要呢。

    软件开发有以下几个主要的阶段(当然我这些肯定不是最全面的)。需求获取阶段——文档设计阶段——代码实现阶段——测试阶段——维护阶段,每一个阶段都离不开文档。

    开发过程中把每一个细小的功能模块的详细实现都要写明白,所有的类图,流程图等等都要写明白,文档写的越细,你对业务逻辑的把控力就越强,对业务的理解就会越透彻,实现起来就会更简单。如果工作做的不细,对于没有经验的人来说,从宏观上去把控业务会有些力不从心甚至跑偏。

    还有一点,文档如果足够详细和明白,就不用太担心项目换人。因为即使还了别人开发,他们也可以通过文档从整体上理解整个项目,这一点对于企业来说至关重要。

    文档先于代码,这点是正确的,但这并不是说,在代码实现之前所有的文档都要写的清清楚楚。因为用户的需求永远都在变,或许用户连自己想要做什么都说不明白,更别说我们这些需求人员和开发人员了。所以有时候,软件的开发是一边写文档一边写代码的,在这种情况下,一定要注意一点:防止软件架构变动。不能让变化的用户需求改变了我们的架构。

    在软件测试阶段,文档也显得尤为重要;单元测试需要参照模块详细说明书;集成测试要参照软件详细设计说明书;黑盒测试要参照用户使用手册;系统测试要参照需求规格说明书、软件详细设计文档,等等。其中,少了任何一个文档,测试人员都无法开始工作。

    综上所述,文档真的是很重

  • 相关阅读:
    (转)HapMap简介
    FASTQ 数据质量统计工具
    CentOS7利用systemctl添加自定义系统服务【转】
    python的pymysql使用方法【转】
    Python使用MySQL数据库【转】
    MySQL全备+binlog恢复方法之伪装master【原创】
    利用binlogserver恢复单表实验【转】
    shell文本左右对齐排版【转】
    关于GTID模式下备份时 --set-gtid-purged=OFF 参数的实验【转】
    mysqlbinlog恢复数据注意事项【转】
  • 原文地址:https://www.cnblogs.com/mawangwang/p/13099449.html
Copyright © 2011-2022 走看看