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 154298 - Finding javadoc API Description is difficult
Summary: Finding javadoc API Description is difficult
Status: RESOLVED FIXED
Alias: None
Product: platform
Classification: Unclassified
Component: Data Systems (show other bugs)
Version: 6.x
Hardware: All All
: P4 blocker (vote)
Assignee: Jaroslav Tulach
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-12-01 20:36 UTC by gwaldon
Modified: 2010-04-09 04:47 UTC (History)
0 users

See Also:
Issue Type: DEFECT
Exception Reporter:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description gwaldon 2008-12-01 20:36:32 UTC 
I noticed that finding API description is becoming more and more difficult since a few releases.

For example there is no clear rule to find the document org-openide-loaders/org/openide/loaders/doc-files/api.html.

Javadoc current entry point for Netbeans API Index is the file index.html. From there I can find easily the overview
summary of the DataSystem API (file org-openide-loaders/overview-summary.html) by clicking Datasystems API in the
content list; I wish I could get to the doc-file API by clicking to the description link (top of the page) but I have to
wander in the page to find a link nice enough to send me finally to the API description (file api.html).

Maybe I miss something but it would be nice to have a clear link for these documents in the overview-summaries.
Comment 1 Irina Filippova 2010-02-16 12:24:07 UTC 
Geertjan, can you please evaluate whether this is something docs can do or not?
Comment 2 Irina Filippova 2010-03-03 11:20:57 UTC 
Reassigning to Geertjan.
Comment 3 Geertjan Wielenga 2010-03-19 07:24:35 UTC 
Nothing I can do about this, reassing to jtulach.
Comment 4 Jaroslav Tulach 2010-03-22 06:49:00 UTC 
I don't think anything is getting more complicated than it used to be. We have this system for ages.
Comment 5 Jaroslav Tulach 2010-04-07 20:27:19 UTC 
Try it now: core-main#45c1269e5596
Comment 6 Quality Engineering 2010-04-09 04:47:30 UTC 
Integrated into 'main-golden', will be available in build *201004090201* on http://bits.netbeans.org/dev/nightly/ (upload may still be in progress)
Changeset: http://hg.netbeans.org/main/rev/45c1269e5596
User: Jaroslav Tulach <jtulach@netbeans.org>
Log: #154298: More prominent link to doc-files documentation