loading请求处理中...

对软件开发文档的总结和感悟

2021-12-01 20:20:51 阅读 9824次 标签: 软件开发 作者: 蓝blue
    代码写多了,软件开发文档写多了总能总结出一堆厚厚的经验之谈。下面就是经年软件开发文档工作者的经验之谈。我们习惯了上来就写代码,通过反复沟通、尝试、迭代、修补,最终完成软件产品(不是完全否定,如果局限在一定阶段是可以的,整个软件开发过程都是这样的方式是有问题的)。当产品完成的时候我们经常百感交集,因为这个过程中承载了我们太多的辛劳也从中学到了很多。我曾经深夜把大家的代码集成起来在完全对称的两个核上模拟出我们自己协议的类LTE通信的功能,这种对称性的美妙使我想起了某个武侠电影中描述的“日月双轮”。
对软件开发文档的总结和感悟

    然而,毕竟是要发展的,不可能一直沿用这样的开发方式,多数成功的企业都是通过软件工程化走出初创时的开发模式,最终发展壮大。子曰:“如有王者,必世而后仁”。孔子说过,刚开始治理的国家,需要经过一段时间以后才能实行仁政。一个组织或团队,实行软件工程化之初的探索是必须要经历的,就像实行仁政之前的那段时间。


    摸索的过程就是为了达到一个基本条件,这其中也包括建立适合的开发文档。软件开发文档是必须的,因为软件有些属于“精神”层面的东西,它的设计意图和思路等重要的信息,仅仅看代码是无法领会到的。对于有一定规模或复杂程度的软件,如果没有文档和记录,是否完成了需求都不好确认,更谈不是测试的充分性。


    认真写文档,写好文档,是我们脱离个人英雄主义,走向集体协作的开始和前提,依靠集体的力量,解脱个人的痛苦,是转变工作方式的开始,是实行软件工程化的必由之路。


    的确,按部就班的开发方式是缺乏激情和惊喜的,因为,结果在计划的过程中已经显现,项目最终才看到成功的惊喜不在。常规的设计、开发、测试流程会去除多数的缺陷和问题,减少了努力加班问题解决之后的成就感,也降低了项目对个人的依赖程度。在规则规范的约束下,软件开发一定程度上缺少了自由的气氛和“创新”的激情,我们都是一颗颗普通的螺丝钉,不再是项目的关键先生。


    对于普通开发人员来说,失去了这么多,我们又能从中得到些什么呢?也许意义就在于这种失去和放下,我们一定程度地“放下”了工作,从满脑子程序代码、调试、BUG中解脱出来,由此换来的是对生活更自由的支配机会。我们虽然年轻,且不幸进入了IT大军,但是年轻的生命也要享受和珍惜阳光、空气以及和家人在一起的时间。工作只是生活的一部分,这是一条无论何时都要提醒自己关注的真理。

公司推荐

成为一品威客服务商,百万订单等您来有奖注册中

留言( 展开评论