你们写java的时候，写javadoc吗？

righttang

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

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

你们平时写不写的？

dalaohu

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

yuba

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

bfox

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

btw, 我也从来没写过。

leonjoho

还要看需不需要generate DOC了

kawara

我连注释都不写。

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

乱码

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

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

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

kawara

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


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

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

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

乱码

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

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

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

你这是我梦想的工作。

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

kawara

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


你这是我梦想的工作。

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

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

乱码

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

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

真服了，你还哭穷

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

starchu

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

tony534

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

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

你们平时写不写的？

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

featheast

我们这几乎每个类和方法都要写javadoc

kane2001

从来不写 写了还要花时间去维护 不然改了代码后面人看了更confuse

stevenbian

一般不用写，要写也写只有自己能看懂的