In an environment where people don't take the time to update comments, they become worthless. In an environment where people do put energy into that, they have value. Simples..
To help others keep comments up to date, reference the class names/method names directly in the comments so that they appear in a usages search (in IDEA anyway, not sure whether Eclipse will do that). On Thu, Apr 18, 2013 at 2:24 PM, Fabrizio Giudici < fabrizio.giud...@tidalwave.it> wrote: > On Thu, 18 Apr 2013 19:16:38 +0200, Reinier Zwitserloot < > reini...@gmail.com> wrote: > > Actually, if you look at something like ArrayList, I don't think much is >> lost if all the comments and javadoc just disappeared, particularly the >> javadoc. 'get(int index)' is all I need to know. >> > > It depends. If one uses sublist(), for instance, he might not precisely > recall whether upper bound is included or not, etc... I don't think get() > is a menaningful example, as most common methods are ok for everybody who's > not a rookie; javadoc is useful for those methods that are useful, but you > seldom use. > > > -- > Fabrizio Giudici - Java Architect @ Tidalwave s.a.s. > "We make Java work. Everywhere." > http://tidalwave.it/fabrizio/**blog <http://tidalwave.it/fabrizio/blog> - > fabrizio.giud...@tidalwave.it > > -- > You received this message because you are subscribed to the Google Groups > "Java Posse" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to > javaposse+unsubscribe@**googlegroups.com<javaposse%2bunsubscr...@googlegroups.com> > . > To post to this group, send email to javaposse@googlegroups.com. > Visit this group at > http://groups.google.com/**group/javaposse?hl=en<http://groups.google.com/group/javaposse?hl=en> > . > For more options, visit > https://groups.google.com/**groups/opt_out<https://groups.google.com/groups/opt_out> > . > > > -- You received this message because you are subscribed to the Google Groups "Java Posse" group. To unsubscribe from this group and stop receiving emails from it, send an email to javaposse+unsubscr...@googlegroups.com. To post to this group, send email to javaposse@googlegroups.com. Visit this group at http://groups.google.com/group/javaposse?hl=en. For more options, visit https://groups.google.com/groups/opt_out.
