nvaccess
Add documentation hints to the welcome dialog
Reported by clev on 2011-07-23 14:00 Several new NVDA users ignore the existence of an NVDA documentation and the advantages of reading it. I suggest adding one more sentence to the welcome dialog to try helping a little more on this. Thus, the entire welcome text could be like this:
Welcome to NVDA!\n Most commands for controlling NVDA require you to hold down the NVDA key while pressing other keys.\n By default, the numpad insert and main insert keys may both be used as the NVDA key.\n You can also configure NVDA to use the CapsLock as the NVDA key.\n Press NVDA+n at any time to activate the NVDA menu.\n From this menu, you can configure NVDA, get help and access other NVDA functions.\n For more details about NVDA, please see the NVDA user's guide and the key command refference found in the help sub menu, in this same menu.\n
Comment 2 by jteh on 2011-07-24 06:49 Adding an additional sentence seems superfluous to me, since we say the user can "get help" from the NVDA menu. Why is this not enough? If this does indeed need to be changed, I'd suggest rewording that phrase rather than adding another sentence. I think shorter is better in this case.
Comment 3 by briang1 on 2011-07-24 08:24 Very difficult. We as humans tend to have the attitude, if all else fails, then read the manual, so I somehow doubt you would get any further by adding things. There may well be some milage in flagging up help more when the dialogues are redesigned to allow tabbing etc between the various items rather than either opening up one at a time as now though.
I actually find nvda quite intuitive at the getting started level. However, this has to be a personal view.
Any opinions on this matter for new NVDA users? @Qchristensen @jcsteh do you still stick by your comment in https://github.com/nvaccess/nvda/issues/1690#issuecomment-155291825?
I tend to agree that if the user is inclined to look up help first off, they will, otherwise it probably won't make any difference how much prodding we do at the point of the welcome screen. I can't think of any better place to come back and suggest it later, unless we put up a dialog on say the 5th start of the program (nothing scientific behind that, just a number, but by then they've hopefully used the program for a few days, got a bit of a feel for it and could then start to make sense of some of the things in the user guide rather than being bombarded on first run).
If changing that sentence on the Welcome diolog, maybe something like:
From this menu, you can access NVDA settings, tools and help including the NVDA User Guide.\n
However #1951 is approached, i.e. whether the Welcome dialog text is rephrased or the Open User Guide button is added, this ticket will be effectively tackled. Thus, I suggest closing this as a duplicate of #1951. @ehollig
I like the idea. Or provide users shortcuts for NVDA-Menu and may be other important commands. This will make it easier for beginnners.
