Skip to content

Github issue template explanation and examples

Reef Turner edited this page Jun 25, 2018 · 13 revisions

This page is meant to serve as an explanation for how to fill out the Github issue template.

At the top of an issue, feel free to provide a brief overview of the issue. Then try to fill in each of the following sections, being familiar with the markdown syntax will surely aid you in understanding the template.

Steps to reproduce:

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:

  1. Open Chrome
  2. Browse to www.google.com
  3. Type "Hello"
  4. Press Enter

Actual behavior:

This section should tell us what actually happens when these steps are taken.

Example:

An NVDA error sound is heard.

Expected behavior:

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.

System configuration:

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.

NVDA Installed/portable/running from source:

This tells us how you are using NVDA.

Example:

Installed

NVDA version:

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

Windows version:

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

Name and version of other software in use when reproducing the issue:

Typically you can get this information from the "About" dialog of the software.

Example:

Chrome version: 67.0.3396.87

Other information:

This is other information about your setup that you think might be relevant to us.

Example:

Running Windows 10 in a VM

Other questions:

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.

Does the issue still occur after restarting your PC?

Restarting your computer will help to ensure that software is in a fresh state.

Have you tried any other versions of NVDA?

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
Clone this wiki locally