导航:首页 > 程序命令 > 程序员不愿写文档

程序员不愿写文档

发布时间:2022-09-18 15:15:12

① 开发人员为什么不愿意写文档

有以下几点。
1.怕烦
程序员从入门之日起,就在心里埋藏了一颗编程的种子,认为程序员就是编程序的,就是和计算机打交道的,程序就是程序员的全部。无论是在编程之前写文档,还是在编程之后写文档。他们都认为写文档很烦人。
1)文档种类太多。越正规越多。一想到要写那么多的文档,程序员的头都要大了。
2)文档写作要求不低。有格式要求、内容要求,还需要画各种流程图、示意图、关系图、界面图和填写各种表格说明,以及要收集各种资料。虽然没有技术含量,但是要花的时间比编程序多,而且也不一定能写好。
3)在正规的开发公司中一般一个变更就要编写一系列的变更文档。当不断变更时,只有最后的变更文档是最重要的。当我们不知道当前是不是最后一个文档时,我们就不愿意写可能被后面的文档替代的文档。
4)当写了文档之后,就会不断有使用文档的人来询问细节,这些询问往往会让人崩溃。这是因为很难写出让每个人都提不出问题的文档。
2.没空
在很多情况下,程序员都处于一种“时间紧、任务重”状态。在急于得出编程结果的驱使下,程序员一心扑在编程上,恨不得一分钟一个变化,哪有心思和时间先把文档写好再去编程呢?即使他们拥有先把程序编出来,然后再补写文档的想法,但是一旦他们完成一段程序之后,就会立即扑向第二段程序。如此下来,编写文档只能放在项目开发的后期了。你要是真的写文档,那写文档的时间早已将编程时间给挤占了,你的编程工作就完不成了。

② 程序员为什么讨厌写文档

因为没有代码提示功能.

③ 开发人员为什么不愿意写文档

有以下几点。
1.怕烦
程序员从入门之日起,就在心里埋藏了一颗编程的种子,认为程序员就是编程序的,就是和计算机打交道的,程序就是程序员的全部。无论是在编程之前写文档,还是在编程之后写文档。他们都认为写文档很烦人。
1)文档种类太多。越正规越多。一想到要写那么多的文档,程序员的头都要大了。
2)文档写作要求不低。有格式要求、内容要求,还需要画各种流程图、示意图、关系图、界面图和填写各种表格说明,以及要收集各种资料。虽然没有技术含量,但是要花的时间比编程序多,而且也不一定能写好。
3)在正规的开发公司中一般一个变更就要编写一系列的变更文档。当不断变更时,只有最后的变更文档是最重要的。当我们不知道当前是不是最后一个文档时,我们就不愿意写可能被后面的文档替代的文档。
4)当写了文档之后,就会不断有使用文档的人来询问细节,这些询问往往会让人崩溃。这是因为很难写出让每个人都提不出问题的文档。

2.没空
在很多情况下,程序员都处于一种“时间紧、任务重”状态。在急于得出编程结果的驱使下,程序员一心扑在编程上,恨不得一分钟一个变化,哪有心思和时间先把文档写好再去编程呢?即使他们拥有先把程序编出来,然后再补写文档的想法,但是一旦他们完成一段程序之后,就会立即扑向第二段程序。如此下来,编写文档只能放在项目开发的后期了。你要是真的写文档,那写文档的时间早已将编程时间给挤占了,你的编程工作就完不成了。

④ 我想入门

软件质量是被大多数程序员挂在嘴上而不是放在心上的东西!
除了完全外行和真正的编程高手外,初读本书,你最先的感受将是惊慌:“哇!我以前捏造的C++/C程序怎么会有那么多的毛病?”
别难过,作者只不过比你早几年、多几次惊慌而已。
请花一两个小时认真阅读这本百页经书,你将会获益匪浅,这是前面N-1个读者的建议。

一、编程老手与高手的误区

自从计算机问世以来,程序设计就成了令人羡慕的职业,程序员在受人宠爱之后容易发展成为毛病特多却常能自我臭美的群体。
如今在Internet上流传的“真正”的程序员据说是这样的:
(1) 真正的程序员没有进度表,只有讨好领导的马屁精才有进度表,真正的程序员会让领导提心吊胆。
(2) 真正的程序员不写使用说明书,用户应当自己去猜想程序的功能。
(3) 真正的程序员几乎不写代码的注释,如果注释很难写,它理所当然也很难读。
(4) 真正的程序员不画流程图,原始人和文盲才会干这事。
(5) 真正的程序员不看参考手册,新手和胆小鬼才会看。
(6) 真正的程序员不写文档也不需要文档,只有看不懂程序的笨蛋才用文档。
(7) 真正的程序员认为自己比用户更明白用户需要什么。
(8) 真正的程序员不接受团队开发的理念,除非他自己是头头。
(9) 真正的程序员的程序不会在第一次就正确运行,但是他们愿意守着机器进行若干个30小时的调试改错。
(10) 真正的程序员不会在上午9:00到下午5:00之间工作,如果你看到他在上午9:00工作,这表明他从昨晚一直干到现在。
……
具备上述特征越多,越显得水平高,资格老。所以别奇怪,程序员的很多缺点竟然可以被当作优点来欣赏。就象在武侠小说中,那些独来独往、不受约束且带点邪气的高手最令人崇拜。我曾经也这样信奉,并且希望自己成为那样的“真正”的程序员,结果没有得到好下场。

我从读大学到博士毕业十年来一直勤奋好学,累计编写了数十万行C++/C代码。有这样的苦劳和疲劳,我应该称得上是编程老手了吧?
我开发的软件都与科研相关(集成电路CAD和3D图形学领域),动辄数万行程序,技术复杂,难度颇高。这些软件频频获奖,有一个软件获得首届中国大学生电脑大赛软件展示一等奖。在1995年开发的一套图形软件库到2000年还有人买。罗列出这些“业绩”,可以说明我算得上是编程高手了吧?
可惜这种个人感觉不等于事实。

读博期间我曾用一年时间开发了一个近10万行C++代码的3D图形软件产品,我内心得意表面谦虚地向一位真正的软件高手请教。他虽然从未涉足过3D图形领域,却在几十分钟内指出该软件多处重大设计错误。让人感觉那套软件是用纸糊的华丽衣服,扯一下掉一块,戳一下破个洞。我目瞪口呆地意识到这套软件毫无实用价值,一年的心血白化了,并且害死了自己的软件公司。

人的顿悟通常发生在最心痛的时刻,在沮丧和心痛之后,我作了深刻反省,“面壁”半年,重新温习软件设计的基础知识。补修“内功”之后,又觉得腰板硬了起来。博士毕业前半年,我曾到微软中国研究院找工作,接受微软公司一位资深软件工程师的面试。他让我写函数strcpy的代码。
太容易了吧?
错!
这么一个小不点的函数,他从三个方面考查:
(1)编程风格;
(2)出错处理;
(3)算法复杂度分析(用于提高性能)。
在大学里从来没有人如此严格地考查过我的程序。我化了半个小时,修改了数次,他还不尽满意,让我回家好好琢磨。我精神抖擞地进“考场”,大汗淋漓地出“考场”。这“高手”当得也太窝囊了。我又好好地反省了一次。

我把反省后的心得体会写成文章放在网上传阅,引起了不少软件开发人员的共鸣。我因此有幸和国产大型IT企业如华为、上海贝尔、中兴等公司的同志们广泛交流。大家认为提高质量与生产率是软件工程要解决的核心问题。高质量程序设计是非常重要的环节,毕竟软件是靠编程来实现的。
我们心目中的老手们和高手们能否编写出高质量的程序来?
不见得都能!

就我的经历与阅历来看,国内大学的计算机教育压根就没有灌输高质量程序设计的观念,教师们和学生们也很少自觉关心软件的质量。勤奋好学的程序员长期在低质量的程序堆中滚爬,吃尽苦头之后才有一些心得体会,长进极慢,我就是一例。
现在国内IT企业拥有学士、硕士、博士文凭的软件开发人员比比皆是,但他们在接受大学教育时就“先天不足”,岂能一到企业就突然实现质的飞跃。试问有多少软件开发人员对正确性、健壮性、可靠性、效率、易用性、可读性(可理解性)、可扩展性、可复用性、兼容性、可移植性等质量属性了如指掌?并且能在实践中运用自如?。“高质量”可不是干活小心点就能实现的!

我们有充分的理由疑虑:
(1)编程老手可能会长期用隐含错误的方式编程(习惯成自然),发现毛病后都不愿相信那是真的!
(2)编程高手可以在某一领域写出极有水平的代码,但未必能从全局把握软件质量的方方面面。

事实证明如此。我到上海贝尔工作一年来,陆续面试或测试过近百名“新”“老”程序员的编程技能,质量合格率大约是10%。很少有人能够写出完全符合质量要求的if语句,很多程序员对指针、内存管理一知半解,……。
领导们不敢相信这是真的。我做过现场试验:有一次部门新进14名硕士生,在开欢迎会之前对他们进行“C++/C编程技能”摸底考试。我问大家试题难不难?所有的人都回答不难。结果没有一个人及格,有半数人得零分。竞争对手公司的朋友们也做过试验,同样一败涂地。

真的不是我“心狠手辣”或者要求过高,而是很多软件开发人员对自己的要求不够高。
要知道华为、上海贝尔、中兴等公司的员工素质在国内IT企业中是比较前列的,倘若他们的编程质量都如此差的话,我们怎么敢期望中小公司拿出高质量的软件呢?连程序都编不好,还谈什么振兴民族软件产业,岂不胡扯。

我打算定义编程老手和编程高手,请您别见笑。
定义1:能长期稳定地编写出高质量程序的程序员称为编程老手。
定义2:能长期稳定地编写出高难度、高质量程序的程序员称为编程高手。
根据上述定义,马上得到第一推论:我既不是高手也算不上是老手。

在写此书前,我阅读了不少程序设计方面的英文着作,越看越羞惭。因为发现自己连编程基本技能都未能全面掌握,顶多算是二流水平,还好意思谈什么老手和高手。希望和我一样在国内土生土长的程序员朋友们能够做到:
(1)知错就改;
(2)经常温故而知新;
(3)坚持学习,天天向上。

⑤ 哎!做程序员一年了,感觉有的时候看不懂开发文档,感觉很枯燥老想着看视频入门我这种的是不是可以转行了

现在的你不是考虑转不转行的时候 既然你已经坚持了一年 那最起码基本的能力还是有的 你夜深人静的时候好好想想吧 任何行业 起步都难 难道你转行,头一年能乐得轻松自在嘛?编程工作第一年甚至第二年都是很西辛苦很痛苦的,哥们跟你说实话我也做了一年程序员 今年干了别的行业 才发现根本没我当初想的那么好 也是从头开始 和程序员头一年没差别 所以我明年决定回到开发工作 再干几年 赚点资金再考虑搞别的

⑥ 软件开发 不重视文档,会出现什么问题

没有开发文档指导,程序员们写的代码就会不符合要求啊、不方便二次开发啊、层次混乱啊,对接不通啊等等问题。出在交付前的问题解决了,可是没有开发文档,以后的工作会很困难。
但我感觉啊,小项目前期就不要花费太多精力和事件搞开发文档了,等做完后再补起来就行。
搞敏捷开发的认为写开发文档是很浪费时间和出力不讨好的事情,特别是面对需求变更的情况。
但是么,按照公司要求来吧,经理叫写就写呗。不是特别严,每天开会,每天上报工作进展的话,完成一部分再补齐文档也行哈。
以上纯属个人理解,如与实际情况不符,请参照高人指点。

⑦ Java程序员,你们在项目里写文档么

恩,要写,
这是你做项目前的预备工作啊~
你瞧我们在每学期最后做项目都要交的文档就有20来个包括软件系统分析,测试用例,系统设计报告等等一些。
一个文档就得发上那么2周的时间。
说老实话,如果一个项目没有做项目文档,那么那个软件将来出来一定会有很多的BAG。

⑧ 程序员到底需不需要写文档

您好:
需要写,而且需要好好写。
不论是前期的设计文档,开发文档。

还是后期的测试文档,实施文档,用户手册,FAQ。
这些文档是伴随着整个工作来的。。。
降低沟通成本,提高沟通效率。。。

⑨ 程序员为什么都不喜欢做文档工作

主要的原因是因为程序员不会写文档,写出来的文档不符合规范。

写文档在软件工程当中是非常重要的,CNN非常强调文档的编写,在CNN开发代码是贯穿整个开发过程,记录各种情况,以便追踪,这是复杂的工作,有着详细的编写规范,是软件成败的关键,占整个开发工作量的30—40%,而代码编写只占20%-30%。国外成熟的软件企业大规模生产软件是采用这种方式,中国的软件开发很多还不成熟,只是几个人凭兴趣、爱好独个编写,弄得一塌糊涂。

中国绝大部分程序员都不会写文档!

⑩ 我是个编程的自学者,想当程序员不知道公司写文档是什么意思知道的情给我解释一下,还有具体是怎样工作的

以鄙人在软件公司工作的经验与你分享一下吧。
我们平时做项目,一般有一半以上时间都在管理文档,包括基本设计书,详细设计书,静态样式书,各种UML建模图,单体测试书,系统测试数,结合测试书,DB设计书,DB脚本,以及各种工具类管理文档,如资源文件管理,VBA管理等等,这还不包括项目前期的需求建设书,项目中期与客户交流的反馈书,项目后期的BUG管理书,以及贯穿项目的工程进度表和版本控制书。当然你的代码资源(包括注释,图片,脚本等)也属于文档,需要统一管理。
对于追求简短快的团队,未必会太重视文档的组织与管理,但是一定要相信文档看似浪费时间,其实无形中提高了很大的效率,而且在未来的开发提供了宝贵的参考资料。属于团队积累的一种。

阅读全文

与程序员不愿写文档相关的资料

热点内容
pdf卡片2004 浏览:307
e算量加密锁检测不到 浏览:774
python串口读取数据类型 浏览:758
17年新款宝来压缩机不跳 浏览:105
王者打着为什么服务器升级 浏览:847
aliyunlinux安装 浏览:981
jdk8分层编译 浏览:453
单片机脉冲计数程序 浏览:825
原相机文件夹名 浏览:330
淘宝云服务器靠什么赚钱 浏览:136
单片机同步通信 浏览:259
游戏服务器如何选 浏览:746
和平精英苹果转安卓怎么转不了 浏览:52
伟福单片机实验箱 浏览:157
广东加密货币 浏览:218
利用python批量查询系统 浏览:499
什么app看左右脸 浏览:305
台湾小公主s解压密码 浏览:570
易语言锁机软件源码 浏览:159
迅雷下载完成无法解压 浏览:592