Skip to main content

How much info is too much?

2 replies [Last post]
sfshaza
Offline
Joined: 2004-06-03

The Java Tutorials (note the plural) are really many tutorials combined in a single entity. The "core" tutorial, which was published as a standalone book, describes the core of the Java language. Then there's the Swing tutorial, a sizable chunk of the tutorials describing the client side of things. Finally, there are the "specialized trails", such as JDBC, i18n, 2D, RMI, and so on.

When we write a core or a swing tutorial, we try to stick to information of interest to most people. (The infamous 80/20 rule.) We don't want to overwhelm, so we avoid more esoteric subjects, the more arcane bits of info that are not of interest to most. This is less true of the "specialized" trails which, by definition, are often covering information that most people may not want to know.

Does this make sense to you? Are there any tutorials where we need to more fully explore a subject? Any where we overwhelm with extraneous information?

Thanks for you thoughts.

Sharon

Reply viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.
aberrant
Offline
Joined: 2006-02-02

Sharon,

It's definitely a tough question. Where else does the detailed information go if not in a tutorial? Can there be an "Advanced Topics" section/page for subjects that might need that kind of treatment?

sfshaza
Offline
Joined: 2004-06-03

I think Advanced Topics makes sense. I like separating out the arcane info. Feel free to post (anyone, not just you) what kind of information you'd like to see. It might be worth starting new threads under "Extending the Tutorial" with this sort of request.

Thanks!

Sharon