Support Forums: Message List - Interview on java.sun.com: Adam Bien on Java EE http://www.theserverside.com Most recent forum messages en Jive Forums Silver 5.5.30 (www.jivesoftware.com) Wed, 19 Jun 2013 12:20:40 -0400 My Rules http://www.theserverside.com/discussions/thread.tss?thread_id=48925 Tue, 15 Apr 2008 13:29:50 -0400 Tue, 15 Apr 2008 13:29:50 -0400 Tue, 15 Apr 2008 13:29:50 -0400 Apr 15, 2008 Lee Meador 0 Re: worth their salt http://www.theserverside.com/discussions/thread.tss?thread_id=48925 Wed, 09 Apr 2008 20:51:30 -0400 Wed, 09 Apr 2008 20:51:30 -0400 Wed, 09 Apr 2008 20:51:30 -0400 Apr 9, 2008 Ravi Chen 1 Re: worth their salt http://www.theserverside.com/discussions/thread.tss?thread_id=48925 any programmer worth his salt would understand a decently well written Java code...]]> Tue, 08 Apr 2008 11:04:02 -0400 Tue, 08 Apr 2008 11:04:02 -0400 Tue, 08 Apr 2008 11:04:02 -0400 Apr 8, 2008 MrBigMAN 2 Re: worth their salt http://www.theserverside.com/discussions/thread.tss?thread_id=48925 any programmer worth his salt would understand a decently well written Java code...]]> Sat, 05 Apr 2008 10:23:08 -0400 Sat, 05 Apr 2008 10:23:08 -0400 Sat, 05 Apr 2008 10:23:08 -0400 Apr 5, 2008 Persistability Ltd 3 JavaDoc and Fat Clients clarifications http://www.theserverside.com/discussions/thread.tss?thread_id=48925 Sat, 05 Apr 2008 09:21:34 -0400 Sat, 05 Apr 2008 09:21:34 -0400 Sat, 05 Apr 2008 09:21:34 -0400 Apr 5, 2008 Adam Bien 0 Re: Interview on java.sun.com: Adam Bien on Java EE http://www.theserverside.com/discussions/thread.tss?thread_id=48925 Sat, 05 Apr 2008 06:40:46 -0400 Sat, 05 Apr 2008 06:40:46 -0400 Sat, 05 Apr 2008 06:40:46 -0400 Apr 5, 2008 Ravi Chen 4 Re: Interview on java.sun.com: Adam Bien on Java EE http://www.theserverside.com/discussions/thread.tss?thread_id=48925
It is not JavaDoc of the single class/interface that could give you the bigger picture.
It's the documentation of used patterns/models/architectures that helps you to master the code.
IMHO JavaDoc is useful for the API of...]]> Fri, 04 Apr 2008 07:27:40 -0400 Fri, 04 Apr 2008 07:27:40 -0400 Fri, 04 Apr 2008 07:27:40 -0400 Apr 4, 2008 Guido Anzuoni 0 Don't generalize http://www.theserverside.com/discussions/thread.tss?thread_id=48925 Fri, 04 Apr 2008 06:23:33 -0400 Fri, 04 Apr 2008 06:23:33 -0400 Fri, 04 Apr 2008 06:23:33 -0400 Apr 4, 2008 Karl Banke 0 Javadoc IS GREAT, but the contents not always http://www.theserverside.com/discussions/thread.tss?thread_id=48925 I get really sick of APIs with either NO javadoc, or useless javadoc. What is so controversial about describing what a class is for, what its methods do, and how the parameters effect the return value? I agree that empty javadoc comments...]]> Fri, 04 Apr 2008 01:50:43 -0400 Fri, 04 Apr 2008 01:50:43 -0400 Fri, 04 Apr 2008 01:50:43 -0400 Apr 4, 2008 Adam Bien 0 Re: Interview on java.sun.com: Adam Bien on Java EE http://www.theserverside.com/discussions/thread.tss?thread_id=48925 It is not JavaDoc of the single class/interface that could give you the bigger picture.
It's the documentation of used patterns/models/architectures that helps you to master the code.
IMHO JavaDoc is useful for the API of interfaces,...]]> Thu, 03 Apr 2008 18:53:21 -0400 Thu, 03 Apr 2008 18:53:21 -0400 Thu, 03 Apr 2008 18:53:21 -0400 Apr 3, 2008 fzammetti 1 Re: Interview on java.sun.com: Adam Bien on Java EE http://www.theserverside.com/discussions/thread.tss?thread_id=48925 Thu, 03 Apr 2008 13:13:29 -0400 Thu, 03 Apr 2008 13:13:29 -0400 Thu, 03 Apr 2008 13:13:29 -0400 Apr 3, 2008 Nikita Ivanov 0 Re: Interview on java.sun.com: Adam Bien on Java EE http://www.theserverside.com/discussions/thread.tss?thread_id=48925 Let's get some simple things out of the way (some of which are tangential to Adam's thesis I admit, but related none the less):

1. Anyone who thinks commenting in general is useless is themselves useless and will never be a member of...]]> Thu, 03 Apr 2008 09:51:11 -0400 Thu, 03 Apr 2008 09:51:11 -0400 Thu, 03 Apr 2008 09:51:11 -0400 Apr 3, 2008 Guido Anzuoni 2 Re: Interview on java.sun.com: Adam Bien on Java EE http://www.theserverside.com/discussions/thread.tss?thread_id=48925 In my team, Javadoc is a code and gets thoroughly code-reviewed regularly. Anybody who would voice the above sentiment seriously would be fired the same day (never happened) as it is clear indication of sheer lack of understanding what...]]> Thu, 03 Apr 2008 05:47:13 -0400 Thu, 03 Apr 2008 05:47:13 -0400 Thu, 03 Apr 2008 05:47:13 -0400 Apr 3, 2008 david cypers 1 Excuse for laziness... http://www.theserverside.com/discussions/thread.tss?thread_id=48925 Thu, 03 Apr 2008 04:13:22 -0400 Thu, 03 Apr 2008 04:13:22 -0400 Thu, 03 Apr 2008 04:13:22 -0400 Apr 3, 2008 Karl Banke 0 Re: Interview on java.sun.com: Adam Bien on Java EE http://www.theserverside.com/discussions/thread.tss?thread_id=48925 Wed, 02 Apr 2008 20:19:12 -0400 Wed, 02 Apr 2008 20:19:12 -0400 Wed, 02 Apr 2008 20:19:12 -0400 Apr 2, 2008 fzammetti 8