程序员为啥不喜欢写文档 ?
作为一名IT行业的从业者,我来回答一下这个问题。
【程序员为啥不喜欢写文档 ?】 首先,是否需要写接口文档往往与项目规模有比较直接的关系,一些大中型项目是一定要写接口文档的,这一点程序员通常也是比较清楚的,而且文档的编写通常也有一个专门的负责人,往往也需要多个程序员的配合才能完成。
程序员之所以不写接口文档,通常处于三方面原因,其一是项目规模本身很小,接口设计也比较简单,此时程序员往往不会单独抽出时间来写接口文档,实际上这部分工作很多人都可以完成,也没有必要一定要让程序员做;其二是项目本身的接口设计没有最终敲定,此时程序员希望等接口确定之后再写,这也是比较常见的原因之一;其三是程序员本身对于整个项目的接口不了解。
对于程序员来说,编写接口文档通常并不是一件很愿意做的事情,除了以上几点原因之外,程序员编写接口文档通常没有单独的任务指标,而且编写接口文档通常比较耗费时间,这也是很多程序员不愿意编写接口文档的一个重要原因。实际上,在很多项目组中,项目经理通常会参与接口文档的编写工作,另外还会配备专门的人员来完成接口文档的最终汇总。
正常情况下,接口文档在最终生成之后,通常还需要一个详细的校验过程,这个过程需要根据接口文档的描述,来完成对应接口的验证。按照不同的项目应用场景,接口也会有不同的应用场景,通常会向不同的用户开放不同的接口,此时也需要有详细的说明。
我从事互联网行业多年,目前也在带计算机专业的研究生,主要的研究方向集中在大数据和人工智能领域,我会陆续写一些关于互联网技术方面的文章,感兴趣的朋友可以关注我,相信一定会有所收获。
如果有互联网、大数据、人工智能等方面的问题,或者是考研方面的问题,都可以在评论区留言,或者私信我!
■网友
并非是程序员, 估计所有人都不喜欢写枯燥的文档特别是软件开发行业, 需求变动频繁, 代码变动频繁, 文档变成一件很难的事情.主要有如下难点:1. 不愿意写, 浪费时间2. 难写, 没好的写作工具3. 难维护. 这是最难的问题, 几乎无解( 人员离职, 人员变动, 一个细小的因素, 就有可能导致文档的维护性失控), 只能一定程度上缓解一味斥责的同时, 也应当停下来, 听听他们的心声, 听听他们的 why, 或许你心中疑惑可解一二现阶段, 基本只有流程规范的大公司能做好这件事情, 中小公司, 基本靠口耳相传 .a sad thing
推荐阅读
- 招聘都要学历,何来程序员不看学历
- 为啥看到书柜上的藏书会有心旷神怡的感觉
- 银行系统的研发岗(程序员)是不是很难进(校招)推广到国企的研发岗(程序员)呢
- 为啥知乎上普便有一种【我在北上广深打工,所以拥有更好的视野】这样的错觉
- 为啥工商银行的用户体验如此之差
- 汽车|看了中消协4S店服务测评调查结果,终于知道法系车为啥卖不好了
- 你为啥从窝窝商城离职?
- 坐标合肥,请问在哪里能捕捉到程序员这种生物他们大都出现在哪里呢
- 怎样成为一名合格的Python程序员?
- 为啥5G和2.4G默认的BSSID是相同的