新足迹 › 论坛 › 兴趣爱好区 › IT与科技 › IT专业论坛 › 你们写java的时候，写javadoc吗？

精华好帖回顾
· 发布一个预测：澳元在今后几年（两年）大概率维持在4-5之间兑换人民币 (2014-9-11) 大桥西	· 悉尼Hyundai Santa Fe购买记（会不会是最便宜的价格呢？） (2012-5-29) sydneydodo
· 近日小菜－生炸云吞、K三文鱼汤、手工大肉包、香菇腐竹炖大肉、肉燥卤蛋、凉拌牛舌 (2007-7-2) 豆豆猫	· 我的租房经历，与无良中介的斗争（1月25日更新） (2006-1-20) Michaelzyu

查看: 1554|回复: 15

你们写java的时候，写javadoc吗？ [复制链接]

righttang

金靴族

发表于 2011-2-16 15:44 |显示全部楼层

此文章由 righttang 原创或转贴，不代表本站立场和观点，版权归 oursteps.com.au 和作者 righttang 所有！转贴必须注明作者、出处和本声明，并保持内容完整

如果公司不是硬性规定的话

今天被同事问了一句，楞了一楞，一般写代码，就在关键的地方写上注释，比如说这个是排序，这个返回错误，这个跳出什么的。
不过没有写过正式的javadoc，也就是那个
/**
*
*/的东西

你们平时写不写的？

dalaohu

金靴族

发表于 2011-2-16 15:48 |显示全部楼层

必写

此文章由 dalaohu 原创或转贴，不代表本站立场和观点，版权归 oursteps.com.au 和作者 dalaohu 所有！转贴必须注明作者、出处和本声明，并保持内容完整

vS里 comment和doc 符号不一样。／／／

yuba

银靴族

发表于 2011-2-16 16:30 |显示全部楼层

此文章由 yuba 原创或转贴，不代表本站立场和观点，版权归 oursteps.com.au 和作者 yuba 所有！转贴必须注明作者、出处和本声明，并保持内容完整

没人生成javadoc文档的话就不写，说明没人要看。

bfox

皮靴族

发表于 2011-2-16 16:52 |显示全部楼层

此文章由 bfox 原创或转贴，不代表本站立场和观点，版权归 oursteps.com.au 和作者 bfox 所有！转贴必须注明作者、出处和本声明，并保持内容完整

产品应该要写，基础的框架的代码要写。项目我觉得就不必要了。

btw, 我也从来没写过。

leonjoho

银靴族

发表于 2011-2-18 22:17 |显示全部楼层

此文章由 leonjoho 原创或转贴，不代表本站立场和观点，版权归 oursteps.com.au 和作者 leonjoho 所有！转贴必须注明作者、出处和本声明，并保持内容完整

还要看需不需要generate DOC了

kawara

水晶靴族

发表于 2011-2-18 22:21 |显示全部楼层

此文章由 kawara 原创或转贴，不代表本站立场和观点，版权归 oursteps.com.au 和作者 kawara 所有！转贴必须注明作者、出处和本声明，并保持内容完整

我连注释都不写。

不过话说回来，我从事java编程近十年，总共写了不到1000行带码

乱码

银靴族

发表于 2011-2-18 22:28 |显示全部楼层

此文章由乱码原创或转贴，不代表本站立场和观点，版权归 oursteps.com.au 和作者乱码所有！转贴必须注明作者、出处和本声明，并保持内容完整

原帖由 kawara 于 2011-2-18 22:21 发表
我连注释都不写。

不过话说回来，我从事java编程近十年，总共写了不到1000行带码

1年不到100行 -- 您老全在给人家review吧？

kawara

水晶靴族

发表于 2011-2-18 22:35 |显示全部楼层

此文章由 kawara 原创或转贴，不代表本站立场和观点，版权归 oursteps.com.au 和作者 kawara 所有！转贴必须注明作者、出处和本声明，并保持内容完整

原帖由乱码于 2011-2-18 22:28 发表

1年不到100行 -- 您老全在给人家review吧？

我职业生涯的绝大部分时间都在上网东看西看，历史或者购物信息。

个别时候忙几天，解决问题不需要写代码，或者极少量的代码。

乱码

银靴族

发表于 2011-2-18 22:39 |显示全部楼层

此文章由乱码原创或转贴，不代表本站立场和观点，版权归 oursteps.com.au 和作者乱码所有！转贴必须注明作者、出处和本声明，并保持内容完整

原帖由 kawara 于 2011-2-18 22:35 发表

我职业生涯的绝大部分时间都在上网东看西看，历史或者购物信息。

个别时候忙几天，解决问题不需要写代码，或者极少量的代码。

你这是我梦想的工作。

我在家不正经干一个月手巧的代码量也要上千

kawara

水晶靴族

发表于 2011-2-18 22:43 |显示全部楼层

此文章由 kawara 原创或转贴，不代表本站立场和观点，版权归 oursteps.com.au 和作者 kawara 所有！转贴必须注明作者、出处和本声明，并保持内容完整

原帖由乱码于 2011-2-18 22:39 发表

你这是我梦想的工作。

我在家不正经干一个月手巧的代码量也要上千

不挣钱啊，哪像老大那样一跳槽就是高薪

乱码

银靴族

发表于 2011-2-18 22:45 |显示全部楼层

此文章由乱码原创或转贴，不代表本站立场和观点，版权归 oursteps.com.au 和作者乱码所有！转贴必须注明作者、出处和本声明，并保持内容完整

原帖由 kawara 于 2011-2-18 22:43 发表

不挣钱啊，哪像老大那样一跳槽就是高薪

真服了，你还哭穷

等我那边撑不下去了，我去跟你混阿

starchu

铜靴族

发表于 2011-2-19 12:47 |显示全部楼层

此文章由 starchu 原创或转贴，不代表本站立场和观点，版权归 oursteps.com.au 和作者 starchu 所有！转贴必须注明作者、出处和本声明，并保持内容完整

写的话便于后续人员的维护或者扩展，是好习惯，在大型复杂系统开发，或者框架开发，或者open source的项目，是必要的，如果只是一般的项目，又没有后续代码开发或者维护的问题，在时间压力上，很多都可以不写，给类，方法写一个比较有意义的名字，有好的unit test，就可以了

tony534

木屐族

发表于 2011-3-27 21:03 |显示全部楼层

此文章由 tony534 原创或转贴，不代表本站立场和观点，版权归 oursteps.com.au 和作者 tony534 所有！转贴必须注明作者、出处和本声明，并保持内容完整

原帖由 righttang 于 2011-2-16 15:44 发表
如果公司不是硬性规定的话

今天被同事问了一句，楞了一楞，一般写代码，就在关键的地方写上注释，比如说这个是排序，这个返回错误，这个跳出什么的。
不过没有写过正式的javadoc，也就是那个
/**
*
*/的东西

你们平时写不写的？

你们的客户是程序员还是最终用户？
程序员的话，必须写，最终用户可不写。