This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 30321 - Examples need to be handled better.
Summary: Examples need to be handled better.
Status: NEW
Alias: None
Product: ide
Classification: Unclassified
Component: UI (show other bugs)
Version: 3.x
Hardware: All All
: P3 blocker (vote)
Assignee: issues@ide
Depends on:
Reported: 2003-01-23 22:35 UTC by Dirk Ruiz
Modified: 2008-09-22 15:33 UTC (History)
6 users (show)

See Also:
Exception Reporter:


Note You need to log in before you can comment on or make changes to this bug.
Description Dirk Ruiz 2003-01-23 22:35:58 UTC
There are currently a number of problems with how
are handled in NetBeans.  These include:

1.  There are too many places where examples might be
stored.  They might be in the userdir, on the web,
in the
file-creation templates, and so on.  This leads to

2.  Storing examples in the userdir causes problems.
Whenever a userdir is wiped and refreshed, the
are always recreated, whether or not the user
wants them.
Furthermore, having an automatically-mounted examples
directory often tempts users to put code there,
which is
then lost when the userdir is destroyed.

3.  Modules have no easy way to extend examples. 
Some of
the example storage methods (particularly, putting
them on
the web) do not allow modules to easily extend the
set of

4.  It is hard to handle examples of varying
Examples might range in complexity from a single
file or
code snippet to multiple files, mounted jars, etc.
Whatever solution we come up with has to handle all of
these cases.

5.  Users have no control over which examples are
displayed, nor do they have any convenient way to
the entire set of examples.  The userdir examples are
always there, and aside from directory names there
is no
hint as to what each example is about.

The solution to these problems has to be worked
out in a
UI spec.  However, to get things going, the following
solution is proposed.  Examples should be kept on the
user's local disk (or in a place of her choosing).
example should be in its own subdirectory, and should
contain an html page describing that example.  The
should be able to access a single page that is
from the example set that is currently on the
disk.  This
page should let the user click on an example in
order to
load it into the IDE.  The user should be able to
the examples on disk from the web, e.g., by
more example directories from the portal.
Comment 1 Patrick Keegan 2003-01-24 14:37:46 UTC
Dirk, this sounds pretty good to me. 

One tiny nit: the page describing the example should probably be plain 
text since the default (double-click) action for HTML files is to open 
them up in the source editor.
Comment 2 eakle 2004-04-08 00:08:03 UTC
Is also nice if the examples are repeatable.  So it would be good if 
the user doesn't have to modify the example "source"; that way they 
can create the same example multiple times (e.g., modify example, not 
like what they did, throw that away, and create it again).