Update Help menu to include more links - split out docs#15688
Conversation
|
Aside from the fact that changing accelerator keys would (as it always does) cause annoyance for users (but I assume you have considered that and decided that these improvements justify it), I'm not sure I understand the reasoning behind moving of the 'check for updates' item out of the help menu. Looking at other programs I have installed the only one in which ability to check for updates is not in the help menu is MS Office, though that is likely because it auto-updates in the background. In all other cases (Firefox, JAWS, Acrobat Reader, Notepad++, VS Code...) this option is in the help menu, so that seems to be standard placement. It is also worth pointing out, though this may may affect only more advanced users, that for try builds, source copies, etc. this option is hidden, so if i weren't following this thread, updated to the version with this change,pressed NVDA + N -> H -> C (as I've been doing for years to check for updates), and notice that the option is not there, it is likely I would try to debug why my update check stopped working, and don't think to look throughout the entire menu. If you want to group these options together it appears more logical to move "install pending update' to the help menu, rather than the other way around. Also has it been considered to make 'documentation' a sub menu of the help menu, instead of its own, independent menu? |
|
We'd like more feedback on these changes before making a decision and merging |
Depth is more annoying to navigate, and only 2 of the docs in the submenu are related to "help" (user guide, key commands). |
|
I'm not a big fan of changing the entry for checking for updates and documentation, besides breaking the accelerator habit would be confusing, there are many external tutorials or add-on documentation that may also mention the path to these documents. |
|
Many applications include the Check for/Install updates option, at the top of
their About dialog, with the version number. That doesn't mean we should, it is
just one of the common placements.
Others, as @lukaszgo1 said, put it in the Help menu if they have one.
Rarely have I noticed it in the main Window, which for us would be on the main
menu.
Personally I prefer that it remain where it has traditionally been.
|
|
The only way I think a Documentation submenu would be a good idea, is if we
start encouraging add-on authors to place documentation there as well, or if we
do that programatically like the Add-on Documentation add-on does.
Otherwise, if it's just the few NVDA docs themselves, a submenu seems like
overkill, and I agree with @seanbudd's approach.
|
The main reason to move it is for discoverability and to keep it with the "install pending update" item. Moving the other item to the help menu would decrease the discoverability of pending updates. We can stick with convention but checking for an update doesn't really fit under "Help" logically. |
It may be more discoverable visually, but for blind users this does not really matter - they need to move through the entire menu to find it regardless in which one these options are placed. I would say the main way people install pending updates is either from the pending update reminder on startup, or from the exit dialog, though I don't have any scientific evidence to back this up. |
|
Considering it is safer to stick with convention for the check for update, that change has been reverted |
See test results for failed build of commit d4979a25c7 |
|
I think this PR was merged too early. He doesn’t seem to be hearing enough from the community. In my opinion, "documentation" also falls under the category of help. |
|
I also comment a bit late. Anyway here is my personal impression: At last, I note that adding more items pointing on NV Access website may not be so interesting for non-English speaking users of NVDA; this issue was already present with the link on the main page of NV Access website, but adding these new links makes it more noticeable. |
|
It looks like the "check for updates" reversion wasn't successful, and its placement in the root menu is confusing, misleading, and breaks years of muscle memory. I like the proposal by @CyrilleB79 to restore the "documentation" items back to the help menu, and add a "useful links" (or similar) submenu. |
|
Lets move the discussion to #15740. Comments on closed pull requests are easily missed. |
|
Actually the discussion takes place in #15749. |
Fixes #15749 Partially reverts #15688 Summary of the issue: There has been significant negative feedback to the creation of the documentation menu. Instead items should be return to the help menu. Given that there is now 11 items in the Help menu, more separators should be added. Description of user facing changes The new help menu structure is: User Guide Key commands Changes [separator] NV Access website NV Access Get Help page NV Access Shop page [separator] License Contributors [separator] Welcome dialog Check for update About dialog Description of development approach Move items back, remove internal variable menu_help which duplicated self.helpMenu
Link to issue number:
Fixes #14631
Summary of the issue:
Description of user facing changes
New menu structure, previously these were all under "Help"
Accelerator keys had to be updated due to the moving of items.
Description of development approach
https://nvda-project.org/was updated to the current NV Access website URL, and the entry for the Menu item has changed from "NVDA website" to "NV Access website".httpsversion of the NV Access website URLTesting strategy:
Test opening menu items manually
Known issues with pull request:
Code Review Checklist: