看啥推荐读物
专栏名称: 码农翻身
工作15年的前IBM架构师分享好玩有趣的编程知识和职场的经验教训, 不容错过。
今天看啥  ›  专栏  ›  码农翻身

写文档没啥用,别写了!

码农翻身  · 公众号  · 程序员  · 2020-04-03 08:50
更多技术漫画,尽在码农翻身后记:相信很多程序员都深有体会,写文档真是一件痛苦的事情,正如文章中所说,需求会变,文档如果不跟着变就会过时,过时的文档甚至会产生误导的作用。可是呢写文档又是一件不能给自己立刻带来什么价值的事情,累死累活把代码写完,把bug改完,下一个任务就在那里压着,还要求写文档,这就太要命了吧!所以大家都不愿意写文档,于是就造成了一种怪圈:大家看代码的时候都希望有文档辅助, 但是又没人写文档。我觉得一个项目的文档没有必要写得面面俱到,事无巨细,那样确实费时费力,但是有几类文档是必不可少的。首先是需求文档,一般是Use Case的方式,主要描述需求,里边有角色和业务流程,正常分支和异常分支, ………………………………

原文地址:访问原文地址
快照地址: 访问文章快照