精彩专题 |
如何做好项目沟通计划
软件项目质量管理
国际工程索赔与反索赔
|
更多:
|
|
联系社区管理员 |
咨询电话 010-82273401/11
斑竹申请 admin@mypm.net
版权所有 © 2003-2004
京ICP证070584号
BBS业务许可2007第353号
最佳显示模式:1024*768像素
|
|
|
[讨论] 软件产品中的“领衔主演”。。。? [发表于 2004/1/30] 状态 开放帖 浏览量 3110 |
|
作为思维产物的软件产品,需要很多注释,而且这些注释是一步步的深入得到的,这些注释就是我们所谓的文档,相对于代码,注释本身没有任何运行价值。。。他们存在的价值在于:促进沟通和理解 软件工程很强调软件文档的重要性,打开RUP的结构图,遍地都是文档(掉入了文档的海洋。。。)---大型软件开发,很需要这样复杂的注解结构,原因很简单:面对一个复杂问题,就是一步步的分解之,分解到可以容易的解决为止,所以问题的复杂程度决定了文档结构的复杂程度和量的多少。。。。但是无论有多少文档,他们都是软件产品中的配角,代码本身才是“领衔主演~”。 随软件问题的复杂化,强调软件文档的重要性是无可厚非的,就像项目管理中怎样强调沟通都不过分一样,但是和沟通一样,这些都仅仅是方法而已,如果形而上的作文档,那可是迂到家了 :( 但是,往往会形式化的作文档,我的团队中就有那么CASE,我建立了一个方法,并版本化了模版,解释了使用方法,聪明的人做一遍后就能很好的使用模版,并提出修订建议,迂人则往往用了N遍后还在形式上硬套(在形式上完成了,--交差心态),写出来的文档不知所云,与建立该方法的目的相差千里。。。 一点想法,聆听大虾们的看法~~
|
-------------------------------------------------------------------------------------------------------- ****有问题,找IT项目管理****... ITPM在线:QQ群-8721636;BB群(msn)- group3730@bbqun.com ;高级M群(msn)- group151431@xiaoi.com (PMP+5年以上PM经验,需验证!) One Aim,One God,One Life. || 最爱:偶家阳阳 || 博客:愚人camer || MSN:camellxr@hotmail.com >>> 由论坛统一发布的广告:
|
|
楼主
camer
职务 无
军衔 上将
来自 广东
发帖 2745篇
注册 2003/3/3
PM币 14759
经验
|
|
Re:[讨论] 软件产品中的“领衔主演”。。。?
[回复于 2004/2/3]
|
对于代码注释我是非常重视的,我对我的开发团队的代码注释要求也非常高,通常要求代码和注释的比例达到了1:1,同时我们也制定了注释的规格和标准。这样的注释让别人看起来非常详细,而且代码的可读性增强了。
|
|
|
1楼
mkopen
职务 无
军衔 二等兵
来自 浙江
发帖 189篇
注册 2003/6/11
PM币 425
经验
|
|
Re:[讨论] 软件产品中的“领衔主演”。。。?
[回复于 2004/2/4]
|
对于代码注释,也是灵活对待的,比如简单的get/set方法(这样的方法还不少),我就不强调注释,只要解释清楚属性含义即可(注释模版自动化生成~~)。。。。 敏捷建模认为,用于沟通的文档本身没有什么价值,如果谁仅仅因为文档作品而“有成就感”,那就偏离了软件开发的价值,所有的文档(项目外的项目干系人要求的文档除外)都是为代码服务的。。可运行的、持续升级的系统是软件开发的核心价值
|
-------------------------------------------------------------------------------------------------------- ****有问题,找IT项目管理****... ITPM在线:QQ群-8721636;BB群(msn)- group3730@bbqun.com ;高级M群(msn)- group151431@xiaoi.com (PMP+5年以上PM经验,需验证!) One Aim,One God,One Life. || 最爱:偶家阳阳 || 博客:愚人camer || MSN:camellxr@hotmail.com
|
|
2楼
camer
职务 无
军衔 上将
来自 广东
发帖 2745篇
注册 2003/3/3
PM币 14759
经验
|
|
|