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 35151 - Update DevGuide to reflect latest changes in APIs
Summary: Update DevGuide to reflect latest changes in APIs
Status: CLOSED WONTFIX
Alias: None
Product: projects
Classification: Unclassified
Component: Generic Infrastructure (show other bugs)
Version: 3.x
Hardware: Sun SunOS
: P3 blocker (vote)
Assignee: Vitezslav Stejskal
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2003-07-25 19:41 UTC by Chris Webster
Modified: 2003-12-11 14:25 UTC (History)
0 users

See Also:
Issue Type: TASK
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Chris Webster 2003-07-25 19:41:53 UTC
A look for something like a build target requires
registration via a DataLoader instance. This seems
like this will require many loaders whose only
purpose is to allow a look registration. I like
the ProjectEnvironmentProvider's ability to
register a provider via a mime type. If this could
be done with looks as well, then the requirement
for a loader simply for registering a build target
would be removed.
Comment 1 Chris Webster 2003-07-25 19:56:13 UTC
After looking from the web module project implementation I see this
may just be a documentation issue. There is not sufficient
documentation describing looks registration, but I may be wrong.
Comment 2 Pavel Buzek 2003-07-28 10:28:28 UTC
Chris, you are right this is a documentation issue.

BTW: The first place in docs where I would look for such an
information works :-), see:
 
http://www.netbeans.org/download/prj40_prototype/javadoc/ProjectsIdeAPIs/org/netbeans/api/projects/ide/doc-files/looks.html#mime-types


I think the only part that needs to be updated is the NetBeans
Projects System - Developers Guide, namely:

# Creating a Build Target
# Writing Looks for Nodes in Projects
Comment 3 Pavel Buzek 2003-07-28 10:29:19 UTC
does not qualify as P1 any more, IMO
Comment 4 Chris Webster 2003-07-28 16:49:50 UTC
I think the problem here is the consistency between java doc,
developers guide, and the examples. I think a more consistent model
would be to include the ideas from the developer guide into the
javadoc overview for projects (where different sections could come
from the different overviews). The examples if they are continued must
reflect the best practices (another idea is to remove the examples). 
Comment 5 Vitezslav Stejskal 2003-07-29 09:43:11 UTC
The dev-guide clearly needs another review and update cycle (there is
a lot of bugs filed against it). I'll do that soon. The same applies
to examples (specificaly we should get rid of any Datasystems API usages).

In generall, the dev-guide was always meant to give the overall
picture, summarize and describe concepts. The detailed  specification
of all our APIs should be in their javadoc of course.
Comment 6 Vitezslav Stejskal 2003-11-26 13:18:18 UTC
As described in
http://www.netbeans.org/servlets/ReadMsg?msgId=619519&listName=nbdiscuss the
current work on projects prototype has been stopped.
Comment 7 Vitezslav Stejskal 2003-11-26 14:58:30 UTC
--> VERIFIED