http://www.theserverside.com Most recent forum messages en Jive Forums Silver 5.5.30 (www.jivesoftware.com) Sat, 25 May 2013 12:17:36 -0400 http://www.theserverside.com/discussions/thread.tss?thread_id=36575
I've never had the thime to do this, but I think the tutorials should be split into tiers. Each tier should try to list an explicit set of preconditions to...]]> Mon, 19 Sep 2005 12:57:04 -0400 Mon, 19 Sep 2005 12:57:04 -0400 Mon, 19 Sep 2005 12:57:04 -0400 Sep 19, 2005 Constance Eustace 0 http://www.theserverside.com/discussions/thread.tss?thread_id=36575
Tutorials have a target audience, so let's leave it that way, i passed long time ago over this problem, if i need a tutorial for...]]> Mon, 19 Sep 2005 05:36:26 -0400 Mon, 19 Sep 2005 05:36:26 -0400 Mon, 19 Sep 2005 05:36:26 -0400 Sep 19, 2005 Paul H 0 http://www.theserverside.com/discussions/thread.tss?thread_id=36575
I think annotated Javadoc is a brilliant idea. But while I think Sun is somewhat justified in saying other sites can NOT do it, I think Sun...]]> Sun, 18 Sep 2005 06:32:06 -0400 Sun, 18 Sep 2005 06:32:06 -0400 Sun, 18 Sep 2005 06:32:06 -0400 Sep 18, 2005 Joseph Ottinger 0 http://www.theserverside.com/discussions/thread.tss?thread_id=36575 Note that annotated javadocs have been tried by Javalobby and a few others; there've been objections to such efforts, and in all honesty, while I think an annotated central javadoc is a brilliant idea, I think it's something Sun has to...]]> Sun, 18 Sep 2005 05:30:59 -0400 Sun, 18 Sep 2005 05:30:59 -0400 Sun, 18 Sep 2005 05:30:59 -0400 Sep 18, 2005 Sathya Srinivasan 1 http://www.theserverside.com/discussions/thread.tss?thread_id=36575 When I go to the API to look up the documentation on a method, I just want the technical specs. What's expected in the input and what behavior I can or cannot count on. I don`t want to wade through a tutorial to find this.
I...]]> Sat, 17 Sep 2005 11:57:12 -0400 Sat, 17 Sep 2005 11:57:12 -0400 Sat, 17 Sep 2005 11:57:12 -0400 Sep 17, 2005 Eugene Ciurana 0 http://www.theserverside.com/discussions/thread.tss?thread_id=36575 I would expect the javadoc/Java Tutorial to be merged into a more cohesive document. I believe we`d all win.Cheers,E
Why? When I go to the API to look up the documentation on a method, I just want the technical specs....]]> Fri, 16 Sep 2005 15:20:09 -0400 Fri, 16 Sep 2005 15:20:09 -0400 Fri, 16 Sep 2005 15:20:09 -0400 Sep 16, 2005 James Watson 1 http://www.theserverside.com/discussions/thread.tss?thread_id=36575 To those in this thread who would change Javadoc, I would ask this question: If you open your daily newspaper, and find that it doesn't contain an in-depth scientific study on the eating habits of migratory birds, would you complain? Would...]]> Fri, 16 Sep 2005 14:10:26 -0400 Fri, 16 Sep 2005 14:10:26 -0400 Fri, 16 Sep 2005 14:10:26 -0400 Sep 16, 2005 Eugene Ciurana 2 http://www.theserverside.com/discussions/thread.tss?thread_id=36575
Well, there can not be a definitive way to answer this and it also depends the initial knowledge/idea/concept behind the technology of the person who will be using the tutorial.

I think, a tutorial should essentially have all the topics...]]> Fri, 16 Sep 2005 13:47:24 -0400 Fri, 16 Sep 2005 13:47:24 -0400 Fri, 16 Sep 2005 13:47:24 -0400 Sep 16, 2005 Parag Wargantiwar 0 http://www.theserverside.com/discussions/thread.tss?thread_id=36575 Fri, 16 Sep 2005 13:44:18 -0400 Fri, 16 Sep 2005 13:44:18 -0400 Fri, 16 Sep 2005 13:44:18 -0400 Sep 16, 2005 Ross Bamford 3 http://www.theserverside.com/discussions/thread.tss?thread_id=36575 Anyone @ Sun care to comment?
No, Sun will not comment. Why should they? They are a research company, and you are now only a simple web site that brings news to developers.

Sun will not comment.]]> Fri, 16 Sep 2005 13:31:58 -0400 Fri, 16 Sep 2005 13:31:58 -0400 Fri, 16 Sep 2005 13:31:58 -0400 Sep 16, 2005 Sujan J20 4 http://www.theserverside.com/discussions/thread.tss?thread_id=36575
Staying on the original question, my ideal tutorial will have information on target audience, tools needed and...]]> Fri, 16 Sep 2005 11:19:05 -0400 Fri, 16 Sep 2005 11:19:05 -0400 Fri, 16 Sep 2005 11:19:05 -0400 Sep 16, 2005 Chintan Rajyaguru 0 http://www.theserverside.com/discussions/thread.tss?thread_id=36575 two-way street, involving a communicator and an audience. Developing tutorials without a conception of the knowledge level of the audience will fail.

I like the concept of Shu...]]> Fri, 16 Sep 2005 11:05:15 -0400 Fri, 16 Sep 2005 11:05:15 -0400 Fri, 16 Sep 2005 11:05:15 -0400 Sep 16, 2005 Roy Tock 0 http://www.theserverside.com/discussions/thread.tss?thread_id=36575 brilliant idea, I think it's something Sun has to do rather...]]> Fri, 16 Sep 2005 10:28:21 -0400 Fri, 16 Sep 2005 10:28:21 -0400 Fri, 16 Sep 2005 10:28:21 -0400 Sep 16, 2005 Joseph Ottinger 7 http://www.theserverside.com/discussions/thread.tss?thread_id=36575 Fri, 16 Sep 2005 10:02:48 -0400 Fri, 16 Sep 2005 10:02:48 -0400 Fri, 16 Sep 2005 10:02:48 -0400 Sep 16, 2005 Guglielmo Lichtner 0 http://www.theserverside.com/discussions/thread.tss?thread_id=36575 came from Sun, Apache, or an independent open-source or private provider: the
API (what to use) and the HOWTO are almost always in separate places. This
results in...]]> Fri, 16 Sep 2005 09:59:43 -0400 Fri, 16 Sep 2005 09:59:43 -0400 Fri, 16 Sep 2005 09:59:43 -0400 Sep 16, 2005 Eugene Ciurana 8