社区
C++ Builder
帖子详情
大家说说,写程序时除了写注释外还要写哪些文档?
jianlinlong
2002-10-15 06:07:54
帮忙讨论一下。这些文档包括哪些内容。
...全文
26
15
打赏
收藏
大家说说,写程序时除了写注释外还要写哪些文档?
帮忙讨论一下。这些文档包括哪些内容。
复制链接
扫一扫
分享
转发到动态
举报
写回复
配置赞助广告
用AI写文章
15 条
回复
切换为时间正序
请发表友善的回复…
发表回复
打赏红包
imickey
2002-10-17
打赏
举报
回复
建议看一些软件工程的书,编码可能只占20%或者更少
june37
2002-10-17
打赏
举报
回复
学习!谢谢!
猛禽
2002-10-17
打赏
举报
回复
如果是按CMM/RUP一类的做法,楼上所说的文档,多多益善
如果是按XP的做法,那除了SOURCE,什么都不要,连注释都尽量少
xdspower
2002-10-17
打赏
举报
回复
你参考网上的一些比较好的实际代码,特别是老外的,真的是好的例子!
此外你还要写设计报告的!
gfh21cn
2002-10-17
打赏
举报
回复
找本软件工程书看一看
呵呵
再根据你的实际情况决定需要哪些文档。
Dermao
2002-10-16
打赏
举报
回复
学习
yyfzy
2002-10-16
打赏
举报
回复
《需求分析报告》
《可行性分析报告》
《概要设计说明书》
《数据库设计说明书》
《详细设计书》
《测试报告》
《用户手册》
还要编写“在线帮助”
……
mynameis007
2002-10-15
打赏
举报
回复
一般在每个文件的开头还有该文件的主要功能,函数,作者,更改日志等.
大大怪老张
2002-10-15
打赏
举报
回复
整个软件开发过程都需要有关文档.
楼上的那些都有模板可用.
不过个人认为单独工作的话不必做死,协同合作的话就要按部就班了.
ysh
2002-10-15
打赏
举报
回复
《需求规格书》、《概要设计说明书》、《数据库设计说明书》、《详细设计书》、《测试报告》、《用户手册》......
这些都有国家标准的。
僵哥
2002-10-15
打赏
举报
回复
你怎么想到的当然别人不管,只是告诉别人你是怎样解决问题的。别人要么就使用你的这种方法去容易的解决复杂的问题,或者是看你的解决问题的方法是否正确(这一点很重要)。所以程序不是要为了能写程序而写程序,而是为了能解决问题而写程序。具体的问题具体的方案才有具体的代码,难道你写程序时不是这样做的吗?无可置疑都会是这样的,只是具体的问题的差别。
jianlinlong
2002-10-15
打赏
举报
回复
是不是要写些模块是干什么用的,当时写这些代码是如何想到的这些东西。
僵哥
2002-10-15
打赏
举报
回复
当然最起码的是每个模块的功能等。这最终取决于你的程序的规模,应用范围。比如多人开发,那么有些就要写清楚你的程序是做什么的,具体在哪里做了什么(这是由程序来写文档,一般的话都是先写文档后再写具体的执行程序。),特别是一些公用的模块,以及对整个程序起着的决定性的模块更是要求相当的明了,还有就是技术性相当强的模块要求更加的细致。不过对于从需求出发做的开发,那考虑的问题的思路就有着相当逆向的编写思维。那样的话,文档就要求是专门的人员来编写,程序所要编写的文档只是些技术性文档和操作的特定规范(这样的规范通常较少甚至没有)。
大大怪老张
2002-10-15
打赏
举报
回复
呵呵,这涉及到软件工程啦
比如系统分析等等,老多东西了,编码只是一部分. 我也不太懂. 发行的时候还要帮助文件,版权声明等...
想想就头疼...
caina3
2002-10-15
打赏
举报
回复
呵呵~!我是新手,我只是把思路和更改写下来了。不过是放在代码外面的。
Java程序中Doc(
文档
)
注释
详解
许多人
写
代码时总不喜欢
写
注释
,每个程序员如此,嘿嘿,我也一样 不过,话
说
回来,该
写
还是要
写
哦!没人会喜欢一个不
写
注释
的程序员,当然,也没有一个喜欢
写
注释
的程序员,今天,我们就来
说
说
Java
注释
之一——Doc
注释
我们知道,Java支持 3 种
注释
,分别是单行
注释
、多行
注释
和
文档
注释
,我们来看看他们的样子 //单行
注释
/* 多行
注释
*/ /** *@... *.... *
文档
注释
*/ 可能许多萌新不明白,
写
了这些
注释
有什么用呢? 其实是因为初学者的代码量少,没有
注释
也能快速查找、修改.
程序员应该
写
文档
吗?
80% 的
文档
都是无效的,所以多数情况下,程序员都不用
写
文档
,原因如下:多数
文档
都是代码的点缀或者静态的记录已经实现的代码,懂代码的开发人员会直接看代码,不懂代码的开发人员压根不会看。
写
文档
是一件要求极高的工作,就像测试驱动开发,在没有完成开发之前要理解它完成之后的样子。除非是逻辑复杂度极高的代码,否则都应该在实现过程中摸索和调整代码结构,这种效率反而更高。服务代码常变而...
10——基础语法:
注释
Java
注释
:对程序进行
说
明和解释,方便自己和他人读懂程序 分类:单行
注释
、多行
注释
、
文档
注释
码农的自我修养——对代码
注释
的理解(转)
如何
写
好代码
注释
是一个老话题,可以
说
一千个程序员就有一千种不同的理解。 下面是从我自己工作中所看到的,所听到的,结合自己编码的体会谈一下自己的想法。 对代码
注释
的态度大致有三种误区:
注释
很重要,每一行代码都要
写
注释
。
注释
可有可无,为了应付公司的编程规范,QA 的审查,开始拷贝一些函数头
注释
,拷过去什么都不改,连原作者名都不改,只为满足代码
注释
率的要求 无需
注释
,代码即
注释
。 第一种 新员工热情很高,也很有责任心,导师或者项目经理
说
要把
注释
写
清楚啊。于是乎我们就屁颠屁颠的每个变量,每个分支,每行代码都加上
Java三大
注释
首先,我们来
说
说
什么是
注释
。 简单点
说
,
注释
就是注解、解释、旁白、概述、段落大意...,就是对某一段代码的一个概括性的
说
明。 了解了什么是
注释
,我们再来
说
说
为什么要
写
注释
。或者叫
注释
的重要性。 先来看看专业的
说
法:代码
注释
是架起程序设计者与程序阅读者之间的通信桥梁,最大限度的提高团队开发合作效率。也是程序代码可维护性的重要环节之一。 解读一下,软件开发是一个团队合作的事情,你
写
的代码不
C++ Builder
13,825
社区成员
102,678
社区内容
发帖
与我相关
我的任务
C++ Builder
C++ Builder相关内容讨论区
复制链接
扫一扫
分享
社区描述
C++ Builder相关内容讨论区
社区管理员
加入社区
获取链接或二维码
近7日
近30日
至今
加载中
查看更多榜单
社区公告
暂无公告
试试用AI创作助手写篇文章吧
+ 用AI写文章