Hi guys

I am putting together a tutorial on making a ticket for nvda in git hub. I know there are users here who do not know how to create one or even where to go or what to do.

I know when i do it I put in as much info as i can so hopefully it can be fixed. I just do not want to over do it and make it confusing if they do not have to do it when doing a ticket.

This is in draft so for give any mistakes.

Is there stuff i should put into it that i might of left out remember it is for a new user.

I will paste in what i have done so far so it can be moved around and is in draft or parts added or deleted.

Reporting an issue/bug report to NVACCESS

 

Where to go to issue a bug to be fixed

 

 

If you are a user of the NVDA screen reader wheather you use the next snap shot alfa code, the Master snap shot beata code or the stable version of NVDA that is released to the public, if you come across a bug it can be reported at the following web page at https://github.com/nvaccess/nvda/issues

 

Getting a Git hub account or simply signing in

 

To report any issues to be fixed you must have a Git Hub account.  .

If you do not have a Git Hub account you will need to go to the sign up link then press the enter key. It will ask you for a user name, email address, password and once done locate the create a account button then press the space bar or enter key for it to be created.

If you already have a account it is just a matter of locating the sign in link and entering your details to log into git hub.

 

 

After you have signed into git hub

 

 

After you have signed into git hub to report a issue on your page you will have some links and buttons and headings. The first button is a search button, the second a create new button, the third a view profile and more button, and a sign out button.

Searching for a issue on git hub

 

 

Before you report a issue/bug report to NVACCESS you will need to do a search to see if any one else has reported the bug. If one can not be found then you will need to open a new new issue. This is a button.

 

 

There are some other buttons there but the one you want is new issue button. Press the enter key on it and a new section will come up and ask you the following.

 

You can arrow through the page to see all the sections.

 

Press the enter key on this button and a new section will appear. You can arrow up and down this page to get all the information there or jump around with B for buttons

 

As you go down the page you will hear the following.

This may depend if you arrow down the page or jump down by buttons. If you jump down by buttons you will hear the following. For example add header text button, add bold text button, add atalic text button, insert a quote button, insert code button, add a link button, add a bulleted list button, add a numbered list button, add a task list button, insert a reply button, Directly mention a user or team, Reference an issue or pull request, browse button, submit new issue button.

You may find it easier to arrow through rather than use single letter navigation keys to get all of the information.

 

They will need to know the following In the header text edit area what the issue is. For example

 

Under the ### Steps to reproduce:

> A list of the steps you take to demonstrate the problem.

> 

> Example:

> 

> 1. Open Chrome

> 2. Browse to www.google.com

> 3. Type "Hello"

> 4. Notice an error sound when enter is pressed.

 

> Please also remember to attach a zip of any files required to reproduce the issue.

 

### Expected behavior:

> Tell us what should happen.

 

### Actual behavior:

> Tell us what happens instead.

 

They will also need to know the NVDA version wheather it is a next-14027,c80e529f

 Snap shot, or a master snap shot with its version number. Also wheather it is a portable or installed version of NVDA.

 

They may need other information such as if it was > Example: Running in a VM

 

Windows version:

> Example: Windows 10 Version 1607 Build 14393.1066

 

### Other questions:

 

Does the issue still occur after restarting your PC?

 

Have you tried any other versions of NVDA?

> Please list them and the result

 

Browse…

No files selected.

Attach files by dragging & dropping, selecting them, or pasting from the clipboard. 

 

Under this section would be where you would post your NVDA log.

 

Make sure under the general settings in NVDA it is set to Logging level: debug

 

 

After you have filled in the information that that they require locate the submit new issue button and your ticket will be created.

Please note

 

 

For NVACCESS to try and track down any bugs to be fixed you need to have the steps to recreate the problem you are having. Make sure your Logging level: is set to debug is set under the General settings in NVDA. You can also obtain the log which it produces from the Tool.. view log section in NVDA. A log will be produced after you press the enter key on the view log menu. Press the ALT key until a menu drops down then arrow down to you hear NVDA say save log as then press the ENTER key. NVDA will default to the file name then it is a matter of tabbing until you hear a location to save to you are happy with such as the Desk top then shift/tabbing back to the save button then pressing the enter key on the save button.

 

   

For more information on using Git Hub with a screen reader which goes beyond making a ticket please go to the following link at http://bats.fyi/2016/08/19/mastering-github-with-a-screen-reader-part-1/

 

 

 

 

 

 

Gene nz