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 100921 - Items in the main Help menu
Summary: Items in the main Help menu
Status: RESOLVED FIXED
Alias: None
Product: cnd
Classification: Unclassified
Component: -- Other -- (show other bugs)
Version: 6.x
Hardware: All All
: P2 blocker (vote)
Assignee: Thomas Preisler
URL:
Keywords:
Depends on:
Blocks: 104411
  Show dependency tree
 
Reported: 2007-04-13 09:56 UTC by jrojcek
Modified: 2007-08-21 22:31 UTC (History)
9 users (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description jrojcek 2007-04-13 09:56:05 UTC
The Profile menu has its own Help submenu which is the problem when Profiler is an integral part of 
NetBeans IDE.

Recommendation: Move those items that make sense in the "big IDE" from the "Profile | Help" menu into 
the main Help menu. This is the recommendation for the new Help menu:

| Help |
--------
Help Contents
Tutorials                  >
Java BluePrints Solutions
Docs and Support Online
----------------------------
Javadoc Index Search
Javadoc References         >
----------------------------
Keyboard Shortcuts
----------------------------
Welcome
About

This issue should be fixed for 6.0 M10. Please reassign to responsible engineer.
Comment 1 Kenneth Ganfield 2007-05-21 14:20:23 UTC
Where should the Profiler help item go? Listed under Tutorials?


I am not sure if "Tutorials" is the proper term in the menu. We should have a
list of the items that will appear under this menu item to get a better idea of
the content. 

Also what are the criteria that qualifies an item being included under Tutorials
instead of on the Docs and Support page?
Is Docs and Support sufficiently informative?

Currently listed under Tutorials:

> NetBeans Platform Tutorial
> Quick Start Guide
> Using NetBeans IDE

Comment 2 jrojcek 2007-05-28 12:47:21 UTC
I would say the Profiler help should  not stay in its current form. So it's not only about finding the right 
place for its menu item. Looking at the existing help system for NetBeans, the Profiler help should 
integrate as:

- multiple pages into Help Contents window
- a separate section into "Using NetBeans IDE" guide
- a separate "Profiling Quick Start Guide" visible in Help | Tutorials menu (not sure about this one)
- somehow with the Docs and Supporte pages on nb.org (not sure how exactly)

The writers team is the right one to come up with suggestions for the Help menu. I would try to review 
it and provide feedback.
Comment 3 Jiri Sedlacek 2007-05-28 13:42:45 UTC
View and Help submenus removed from Profile menu. Docs team please suggest new 
menu items for general Help menu for M10.
Comment 4 Jiri Sedlacek 2007-07-16 15:23:59 UTC
Resetting target milestone - wasn't implemented for M10. Waiting for docs team suggestions.
Comment 5 Patrick Keegan 2007-07-16 15:40:17 UTC
I don't think there should be a separate menu item. The profiler help should be a part of the basic Java app help.
Comment 6 Jiri Sedlacek 2007-07-17 12:56:06 UTC
I'm sorry but it doesn't seem you have all the information required to decide this problem. There's much more 
documentation available for Profiler than just a JavaHelp - for example HTML docs which should be turned into 
tutorial/guide or something like that. That's the decision I'm asking for - what kind of documentation will be 
available and where it should be placed in Help menu.
Comment 7 Patrick Keegan 2007-07-17 13:12:19 UTC
We are intentionally keeping the Help menu limited and general, so it's not going to point to every tutorial or group of
tutorials (if that was the case, there could be dozens of the items on the menu, which would make it ugly and hard to
manage). I believe that Ken is folding the HTML docs that you are talking about into the Using NetBeans Guide.
Comment 8 Jiri Sedlacek 2007-07-17 13:20:12 UTC
I'll accept whatever solution, just please make the final decision, make sure that usability/HIE are OK with it and 
eventually close this issue.

I would suggest to try to use the profiler without any previous knowledge just based on the JavaHelp (no screenshots 
and detailed information). If you are able to profile without problem, then it's all OK, if not, it would be a 
regression because till now the guide was available for the profiler for first-time users.
Comment 9 Kenneth Ganfield 2007-07-17 16:52:34 UTC
am switching this issue over to usersguide.

The issue started about where to include references to the Profiler web doc helpset, but
this issue concerns the items that should be listed under the Help menu in the IDE and is not limited to the Profiler items.
Comment 10 Kenneth Ganfield 2007-07-24 13:51:19 UTC
we should try to fix and close this issue this week.
I believe the current proposal is the following:

| Help |
--------
Help Contents
Java BluePrints Solutions
Docs and Support Online
----------------------------
Javadoc Index Search
Javadoc References         >
----------------------------
Keyboard Shortcuts
----------------------------
Welcome
About

if this is agreed, we should implement with engineering and close the issue.
btw, Java BluePrints menu item is still not appearing in menu in builds [ie 20070724]
is this going to reappear sometime in the future?
Comment 11 Patrick Keegan 2007-08-02 16:59:35 UTC
Switching the issue to utilities.

The order of the help menu is defined in the menu spec here:

See http://wiki.netbeans.org/wiki/view/MainMenu#section-MainMenu-Help
Comment 12 Patrick Keegan 2007-08-02 17:04:10 UTC
Note that "Online Docs and Support" in the spec uses the same link as the current "Support & Docs" and "Keyboard
Shortcuts Card" uses the same link as the current "Keyboard Shortcuts"
Comment 13 Marian Petras 2007-08-02 18:34:56 UTC
I have done all modifications necessary in the Utilities module.
Modified files:

   utilities/src/org/netbeans/modules/url/Bundle.properties   (1.57)
   utilities/src/org/netbeans/modules/utilities/Layer.xml   (1.98)

Diffs:
http://utilities.netbeans.org/source/browse/utilities/src/org/netbeans/modules/url/Bundle.properties?r1=1.56&r2=1.57&diff_format=u
http://utilities.netbeans.org/source/browse/utilities/src/org/netbeans/modules/utilities/Layer.xml?r1=1.97&r2=1.98&diff_format=u

More changes are necessary in other modules (e.g. rename "Welcome Screen" to "Welcome", change mnemonic characters).

Reassigned to "ui/welcome".
Comment 14 _ rkubacki 2007-08-07 12:05:06 UTC
Mnemomonic of Help|Welcome screen fixed.

/shared/data/ccvs/repository/ide/welcome/src/org/netbeans/modules/welcome/Bundle.properties,v  <--  Bundle.properties
new revision: 1.8; previous revision: 1.7

Passing to javahelp. OTOH this way of bug handling is not very effective. It would be better to file more specific bugs
against components and link to this umbrella.
Comment 15 mslama 2007-08-21 17:14:48 UTC
Fixed mnemonic for item 'Javadoc Index Search':
/cvs/javadoc/src/org/netbeans/modules/javadoc/search/Bundle.properties
new revision: 1.66; previous revision: 1.65

Passing to cnd as there is item 'C/C++ Development Pack FAQ' as first item in Help submenu.
Comment 16 Thomas Preisler 2007-08-21 22:31:01 UTC
CND's FAQ help menu has now been removed (http://www.netbeans.org/issues/show_bug.cgi?id=112796). Itshould fix this IZ too although I'm not sure 
whether there are remaining issues. Pls re-open and reassign if there is.