-
-
Notifications
You must be signed in to change notification settings - Fork 650
Github issue template explanation and examples
This page is meant to serve as an explanation for how to fill out our Github issue template.
The template uses github markdown, to provide formatting for headings, lists, quotes etc. If you are not familiar, please take some time to learn about Github markdown
Warning: In all but exceptional circumstances we require this template to be completed. Your issue will likely be closed if this template has not been followed.
It's important to include any files that are required to reproduce an issue. This might be a required file for an office suite, or a link to a code playground such as CodePen or JSFiddle, or perhaps a standalone HTML file.
In most cases an NVDA log file is incredibly helpful when trying to understand/fix an issue, please remember to attach one. More instructions are available on the wiki. If you are getting a crash dump file (nvda_crash.dmp) please also include it.
While we welcome images/screenshots to help explain a problem, be aware that many of the developers of NVDA are blind and will greatly appreciate this image being described in text. Most tools allow you to copy text out of them.
- Consider swapping to the preview tab in order to read through your issue at any stage to confirm the issue reads as expected.
- If you have trouble following this template, or with the initial investigation that is required, please politely ask for assistance from the fantastic community of people on the NVDA users mailing list
At the start of the template there is a HTML comment block which points to this wiki page, it can be left in place and will not appear once the issue is saved. Feel free to delete it.
After the HTML comment, you may provide a brief overview of the issue. Then fill in each of the following sections:
This section should contain a list of the steps you take to demonstrate the problem. While you are working out the steps required, please make a copy of your NVDA log to attach to the issue.
Example:
- Open Chrome
- Browse to www.google.com
- Type "Hello"
- Press Enter
This section should tell us what actually happens when these steps are taken.
Example:
An NVDA error sound is heard.
This section should tell us what you expect to happen when these steps are taken.
Example:
There should be no error sound, and the page should change to show the search results.
This section has several sub-sections. These are all about the system you are using when encountering the issue. If you are encountering the issue with multiple different configurations, please list them. This helps us to be able to reproduce the issue, or help us to investigate why this issue occurs for some users and not others.
This tells us how you are using NVDA.
Example:
Installed
The version of NVDA that you are using when demonstrating the issue. This can be copied from the about option, in the NVDA help menu.
Example:
next-15370,21fd217a
The version of Windows that you are using, typically you can get this information by typing "About" into the Windows start menu and selecting an option like "About your PC"
Example:
Windows 10 Version 1607 Build 14393.1066
Typically you can get this information from the "About" dialog of the software.
Example:
Chrome version: 67.0.3396.87
This is other information about your setup that you think might be relevant to us.
Example:
Running Windows 10 in a VM
This section has sub-sections, asking about the basic investigation steps you may have completed. Please feel free to add more information here to tell us about what you have tried.
Restarting your computer will help to ensure that software is in a fresh state.
Knowing the whether this issue occurs in previous releases helps to understand if this is a newly introduced issue, and gives us an indication as to whether it is a change in our software or others that has introduced the problem.
Example:
Yes:
- NVDA 2018.1 - no error sound
- NVDA 2018.2 - has error sound
- FAQ
- Application Support
- Connect
- Guides
- Extra Voices
- Log Files And Crash Dumps
- Log Levels (move to userguide / delete?)
This section will be moved to the NVDA repository as a priority
- Internals
- Notes Adding support for aria attributes to browsers
- Using COM with NVDA and Microsoft Word