程序员文档怎么写

1. 为什么程序员不愿写文档

其中的原因很多,我自己归纳了几点:1.怕烦程序员从入门之日起,就在心里埋藏了一颗编程的种子,认为程序员就是编程序的,就是和计算机打交道的,程序就是程序员的全部。

无论是在编程之前写文档,还是在编程之后写文档。他们都认为写文档很烦人。

1)文档种类太多。越正规越多。

一想到要写那么多的文档,程序员的头都要大了。2)文档写作要求不低。

有格式要求、内容要求,还需要画各种流程图、示意图、关系图、界面图和填写各种表格说明,以及要收集各种资料。虽然没有技术含量,但是要花的时间比编程序多,而且也不一定能写好。

3)在正规的开发公司中一般一个变更就要编写一系列的变更文档。当不断变更时,只有最后的变更文档是最重要的。

当我们不知道当前是不是最后一个文档时,我们就不愿意写可能被后面的文档替代的文档。4)当写了文档之后,就会不断有使用文档的人来询问细节,这些询问往往会让人崩溃。

这是因为很难写出让每个人都提不出问题的文档。2.没空在很多情况下,程序员都处于一种“时间紧、任务重”状态。

在急于得出编程结果的驱使下,程序员一心扑在编程上,恨不得一分钟一个变化,哪有心思和时间先把文档写好再去编程呢?即使他们拥有先把程序编出来,然后再补写文档的想法,但是一旦他们完成一段程序之后,就会立即扑向第二段程序。如此下来,编写文档只能放在项目开发的后期了。

你要是真的写文档,那写文档的时间早已将编程时间给挤占了,你的编程工作就完不成了。3.没有用文档的重要性其实对不同对象是不一样的。

如果你说文档没有用,立即会有人用唾沫把你淹死,他们立即会搬出哪个哪个说文档是重要的,文档是不可缺的。唯独不敢说“我自己认为文档是重要的”。

这也反过来说明文档的有用性程度对不同人是不一样的。对于程序员来说,只要能把程序编出来就行了。

很多程序员不写文档照样编出程序来,在他们的观念中文档不写也罢。如果按文档编程序,那就要确保文档的正确性、不可更改性。

而实际上,文档不如编程快,编程不如变化快,不断变化的需求和代码让文档如同一张过时的废纸一样。在现实中,有的文档变成了项目开发后的总结,对开发本身并不起作用,只是保留一个存在的形式,以应付各种各样规范的需要。

在这种情况下,文档没有任何实用价值,所以即使程序员写了,也没有什么作用。尤其是项目投产后,几经升级,最初的文档早已和现实的情况对不上号了,文档更新和系统的一致性更是难于控制。

4.没好处既然认为编程序才是正道,那么程序员写文档就是一种额外和辅助的工作,做了就做了,对于程序员来说没有任何好处。当然,文档的好处更多地体现在软件公司、单位、软件用户、后续程序员身上,它是一种“前人栽树,后人乘凉”的好事。

所以程序员不愿意写文档。文档有多么重要呢?有人把它上升到“程序员头脑的拷贝”的高度,有的人甚至说,程序员走了后,只要有了文档,软件公司可以再招新人,公司照样运转起来。

如此说来,天性聪明的程序员会把文档写得清清楚楚吗?5.不会写从写作本身来看,写好一篇文档不是一件容易的事。文档有文档的格式和写作要求。

现在的人只喜欢动嘴说事,没有多少人在平时会动笔写字,更不用说写文章了。所以,写文档从理论上来说也是需要学习和训练的,需要在平时进行写作积累。

当要求一些程序员写文档的时候,他往往会回答你:“怎么写呀?我不会。”你不会写可以不怪你,你不去学,反而理直气壮地说不会,则是你的不对了。

难道那些会写文档的人都是“呆子”吗?难道他们不懂干活辛苦的道理吗?当一个男子向一个自己喜欢的女子示爱,需要用情书来表白的时候,难道他不会写情书吗?即使他不会写,他也一定会克服千难万险把情书写出来的,这是他的主观使然。如果程序员主观上想写文档,怎么会怕烦?怎么会怕没空?怎么会怕文档没有用?怎么会怕不会写?这些怕其实都是借口。

真正优秀的程序员应该不单是编程的高手,同时也应该是写文档的高手。程序员真正不喜欢写文档的原因是:文档是给别人看的,不是给自己看的。

如果要使程序员喜欢写文档,那就要提高程序员的意识和境界,或者要给写文档的程序员以奖励。而靠制度、管理让程序员去写文档只能是一种职业上的弊端。

当有一天写文档也成为一个专业化的岗位,程序员和文档人员分开时,程序员就会一心一意看文档写代码,文档员就会以此为职业,一心一意写文档拿工资。我们将不再为此进行讨论。

这种分工一定是未来的趋势。一些大的公司或管理规范的公司都已经有这样的分工了。

只是很多中小软件公司或企事业单位里的IT部门还没有专业化到如此程度。程序员不喜欢写文档也许说明他们不愿意承担太多的角色吧。

不管怎么说,作为一个程序员(尤其想成为优秀程序员)一定要学会写文档,一定要学会欣赏文档。无论你是否喜欢,你都应该可以在文档的各种问题面前可进可退。

可以这样说,那些既不会写文档,又不会欣赏文档的程序员是没有资格说“我就不喜欢写文档”这种话的。

2. java面试官问有没有写过文档(面试java程序员),我想知道写文档是

我想他的文档是指在项目开发过程中 不同阶段的文档

我们项目组开发基本是基于瀑布模型开发 每个阶段都会输出文档指导后续工作开展

一般se下发需求后 由我们出 详细需求设计文档

代码开发完成了 转测试时我们会写 数据库设计文档 ,操作手册 (这个也算)

还有就是 版本升级说明书 版本功能清单 软件介绍

这个是大概的文档 还有其他的。文档编写时间 主要是代码开发前 与 转测试后

3. java程序员需要些什么文档

我很少写文档,懒得写,除非项目有要求

对于文档这个东西简单谈一下

1. 做项目之前就有文档

这个是可遇不可求的,现在做的项目很多都是临时突然说要做的,什么需求都没有,只能靠程序员自己去发现,项目经理的要求,客户的临时需求(这个比较痛苦,他们有时候根本就不知道要什么,所以必须写好文档,跟客户谈好,不然又要变的时候,你就痛苦了)

如果项目一开始就有文档,当然也可能是你自己写的,也可能是其他人写好的,有些公司有人专门负责写,需求分档,项目分析文档,项目结构文档,数据库文档等等,不过之后可能需要你写测试文档,这个就没有听说过谁帮你做了,但是更多的情况也是不用写,就几个功能,自己和测试人员测测就算了,也有可能需要写使用文档,这个看情况了

2. 做项目之前没有文档

如果项目紧张,根本就不会写任何文档,但是当项目结束的时候,你又没有项目做,项目精灵可能就让你写写文档打发打发时间,

文档对于公司来说是很重要的,但是对于个人的话,就要看情况,如果你做了很多项目,其实什么文档也不需要,你大体上都知道这个项目就做什么用的,怎么架构的,那些代码是什么意思(你的编程习惯很好的情况下),所以很多公司都会要求程序员写文档,不然你走的时候,别的人怎么接受,让别人理解你的思想是很痛苦的,每个人的思想都是不一样的

4. 我是个编程的自学者,想当程序员不知道公司写文档是什么意思知道

以鄙人在软件公司工作的经验与你分享一下吧。

我们平时做项目,一般有一半以上时间都在管理文档,包括基本设计书,详细设计书,静态样式书,各种UML建模图,单体测试书,系统测试数,结合测试书,DB设计书,DB脚本,以及各种工具类管理文档,如资源文件管理,VBA管理等等,这还不包括项目前期的需求建设书,项目中期与客户交流的反馈书,项目后期的BUG管理书,以及贯穿项目的工程进度表和版本控制书。当然你的代码资源(包括注释,图片,脚本等)也属于文档,需要统一管理。

对于追求简短快的团队,未必会太重视文档的组织与管理,但是一定要相信文档看似浪费时间,其实无形中提高了很大的效率,而且在未来的开发提供了宝贵的参考资料。属于团队积累的一种。

5. 怎样写好软件文档

正文如下:

我不知道是不是有人会将阅读或书写技术文档当**好。虽然很讨厌这样做,但是通常为了解决问题或介绍一个技术产品,我们不得不去做这些事情。要想写好文档很难。技术文档有几种形式:基本概览,高级概览,一步一步的演示,自动生成的文档,等等。考虑下不同用户对你的文档的需求情况:不同的需求,不同的技术,不同的学习风格。你将会发现,没有一种格式能同时适应所有人。受众情况在写项目文档的时候,你首先要考虑到的是读者。最终用户首先需要的是一份入门指南。尽管一些技术概念可能会提到,但是重点应放在用户界面,而不是后台。如果是程序员,他可能会想得到更多的信息:程序运行原理,代码的实现,怎样对代码进行扩展,等等。为部分用户写的文档不应当影响到另一部分用户的阅读,你可以考虑写两份单独的文档,用户使用手册和技术文档。几种不同类型的文档 Jacob Kaplan-Moss在他的怎样写好文档的指南中,他提到了三种文档:教程,专题指南和参考指南。

教程:教程是很重要的,因为这往往是用户在使用新的工具时得到的第一印象。我们之前写到过,有许多不同的工具可以帮你写好教程。如果你想写的话,Kaplan-Moss建议你写得简单快速一些,但是不要太简单了,可以做一个演示,为每一步骤添加相关的截图。专题指南:Kaplan-Moss说这是文档的主要内容。虽然教程提供了一个高层次的概念,但是专题指南可以让感兴趣的人深入学习,内容一定要详尽。Kaplan-Moss提到,一般来说,图书要胜过官方文档,但是后者的一个优点是随时更新。参考指南:参考指南是为那些已经入门但是还需要更多信息的用户准备的。为那些已经知道怎样使用API,但是需要查找确切的函数参数或详细设置信息的用户定制的。要指出的是,参考指南是无法由教程和普通指南替代的。自动生成的文档只能起一个引导作用,如果没有额外的写作,编辑和组织,它是不可能解决大家的问题的。虽然这是“技术写作”,但是这并不意味着你应该放弃文采,语法和拼写检查。至少得检查一下语法和拼写吧。

程序员文档怎么写

转载请注明出处育才学习网 » 程序员文档怎么写

知识

申请购买报告怎么写

阅读(167)

本文主要为您介绍申请购买报告怎么写,内容包括申请购买物资报告怎么写,申请购买图书的报告怎么写,购买办公用品的申请报告怎么写谢谢。原发布者:王雪梅购置物品申请报告 申请报告是个人或集体向组织、机关、企事业单位或社会团体表述愿望、

知识

日语新年快乐怎么写

阅读(185)

本文主要为您介绍日语新年快乐怎么写,内容包括新年快乐用日语怎么说,新年快乐日语怎么写,新年快乐日语怎么说。明けましておめでとうございます新年快乐新年の楽しみを心からお祈りします。衷心祝愿新年快乐,诸事顺遂!新年の楽しみを心からお

知识

越南文字怎么写

阅读(353)

本文主要为您介绍越南文字怎么写,内容包括越南文字怎么写,越南文字是怎样的,越南字怎么写。时下的越南文其实就是拼音文字,可是不是汉语拼音。真正的越南文字的标调比汉语拼音还要多,原音字母上标的调有的像一顶帽子,有的像月亮,有的像

知识

e-mail怎么写

阅读(168)

本文主要为您介绍e-mail怎么写,内容包括Email地址的格式是什么,Email的具体格式,email的正确格式。电子邮件地址有固定有格式,即:用户名+@+mail.server.name,详解如下: “用户名” 是收件人的账号,对于bai同一个邮件

知识

月考质量分析怎么写

阅读(238)

本文主要为您介绍月考质量分析怎么写,内容包括月考质量分析怎么写,质量分析怎么写语文月考质量分析,语文考试质量分析该怎么写。分学科一一分析:要有针对性。语文的话,提一下什么地方写的不错,这个月我在这方面下了怎样的功夫或者学的如何,其中

知识

亚马逊申诉怎么写

阅读(189)

本文主要为您介绍亚马逊申诉怎么写,内容包括亚马逊卖家az向亚马逊申诉都写什么内容,如何做亚马逊申诉,如何申诉亚马逊账号。只要收到A-TO-Z,首要工作就是跟客户进行沟通,能让客户主动撤销是最好,如果客户不同意,还是要收集所有有利的信息来准备

知识

德语德国怎么写

阅读(177)

本文主要为您介绍德语德国怎么写,内容包括德国用德语怎么写,德国用德语怎么说,100词即可.哪位大神帮我这个学渣写一篇德语作文啊,关于德国汽车。deutsch , (das)Deutsch , der/die Deutsche , das Deutsche 辨析deutsch 1

知识

书法你字怎么写

阅读(217)

本文主要为您介绍书法你字怎么写,内容包括草书的你字怎么写,用书法怎么写成字,连笔字怎么写。【花】字的方正字迹-邢体草书简体写法 【花】字的金梅毛草书写法 【花】字的书体坊米芾体写法 【花】字的方正大草简体写法 草书有章草、今草

知识

给公司发函怎么写

阅读(253)

本文主要为您介绍给公司发函怎么写,内容包括给公司发函怎么发,公函格式范文,公司公函范文。给公司发函需要写明是什么事,接着是什么方式。(1)送达函告时可以采取多种方式进行,邮寄、邮件、微信都可发一份,微信、邮件发送时采用扫描件

知识

自我评价英文怎么写

阅读(198)

本文主要为您介绍自我评价英文怎么写,内容包括"自我评价"用英语怎么说,自我评价英语,自我评价英文翻译。自我评价的英文翻译是self-assessment。词汇分析音标:[selfəsesmənt] 释义:自我评估短语self-assess

知识

韩文唯一怎么写

阅读(256)

本文主要为您介绍韩文唯一怎么写,内容包括唯一的韩文怎么写、,韩文唯一怎么写,韩文唯一怎么写。唯一 韩语:유일例:他做到了,因为唯一(유일),所以弥足珍贵。至今仍然念念不忘那个在绝望(절망)和不知所措的爱情中苦苦挣扎的男人。短语:

知识

除夕夜的作文怎么写

阅读(158)

本文主要为您介绍除夕夜的作文怎么写,内容包括除夕夜的作文怎么写,除夕夜的作文怎么写,难忘的除夕夜作文400字,怎么写。难忘的除夕夜 盼啊盼,盼啊盼,终于把这个除夕给盼来了。除夕就像一股团圆风,让每家每户都欢聚一堂。 除夕之夜,我们家里可

知识

和字日语怎么写

阅读(217)

本文主要为您介绍和字日语怎么写,内容包括:和:字用日语怎么写,日语和字怎么写,和字用日语怎么写打一下。如果是音读,则读成 か(ka);如果是训读,则读成 すぎる(sugiru)、すごす(sugosu)、あやまち(ayamachi)则于写法

知识

楷书球字怎么写

阅读(206)

本文主要为您介绍楷书球字怎么写,内容包括球,字怎么写,楷书“小”字怎么写,球字笔顺怎么写。楷书“小”字的写法如下图:笔顺读写:竖折钩撇捺拼 音:xiǎo部 首:小造字法:象形总笔画:3五 笔:ihty词 性:形容词、名词、代词

知识

程序员怎么写文档

阅读(185)

本文主要为您介绍程序员怎么写文档,内容包括为什么程序员不愿写文档,Java程序员,你们在项目里写文档么,程序员到底需不需要写文档。其中的原因很多,我自己归纳了几点:1.怕烦程序员从入门之日起,就在心里埋藏了一颗编程的种子,认为程序员就是编

知识

软件开发的文档怎么写

阅读(189)

本文主要为您介绍软件开发的文档怎么写,内容包括软件开发文档应该如何写,软件开发的技术实现文档要怎么写,怎么写项目开发的文档。模块开发卷宗(GB856788)1标题软件系统名称和标识符模块名称和标识符(如果本卷宗包含多于一个的模块,则用这组模

知识

文档怎么写拼音

阅读(176)

本文主要为您介绍文档怎么写拼音,内容包括怎样在office文档里写拼音,如何在word中写拼音,word中如何输入拼音。在word中写拼音,可以通过下面的操作步骤: 打开word文档,在文档中编辑需要增加拼音的文字,并注意文字间的空格,如下图; 选定要增加

知识

写文档怎么换行

阅读(259)

本文主要为您介绍写文档怎么换行,内容包括word文档怎么换行,Word怎么分行,怎么设置WORD文档的段落自动换行。有两种方法。我喜欢用第一种方法;仅供参考!word自动换行解决方法: 选择格式段落中文版式,勾选“允许西文在单词中间换行”。 注意:这种

知识

在文档里分数怎么写

阅读(231)

本文主要为您介绍在文档里分数怎么写,内容包括在word文档里如何写出分数,如何在word文档中写分数,怎样在word文档里写分数。两种实现方法:一种是用 Word本身提供的的EQ域。这种方法容易操作,但对大量的分数输入来讲太费事。另一种是利用Enter

知识

用手机怎么写文档

阅读(186)

本文主要为您介绍用手机怎么写文档,内容包括在手机上怎么写文档,怎么在手机上填写文档,怎么用手机写word文档。在手机上写文档需先下载办公软件,具体操作如下:先下载wps office 的软件,如下图图标。这款软件下包含了word、Excel等操作

知识

怎么写产品文档

阅读(211)

本文主要为您介绍怎么写产品文档,内容包括如何才能写出好的产品文档,如何写好产品开发文档,手机软件测试产品文档怎么写。一般来说,产品文档分为产品需求文档和产品使用文档两种。产品需求文档主要面向的是产品的开发、设计者,期望是产品的实

知识

帮助文档怎么写

阅读(165)

本文主要为您介绍帮助文档怎么写,内容包括如何编写帮助文档,怎么写一个项目的帮助文档,如何写帮助文档。每个开发人员都知道改写原有的应用程序是一项多么艰苦的事情。对先前开发小组思维模式进行逆向工程是对开发人员技术水平的真正测试。

[/e:loop]