Re: Github


Bhavya shah
 

Hi all,
I see that a lot of NVDA users seem interested in helping out with
testing NVDA, sharing feedback, reporting bugs, etc. As an active
triager on the NVDA Github issue tracker (along with some other NVDA
community members), we try to make sure that all tickets are
systematic and well-defined, so that developers have sufficient
diagnostic information or compelling use cases ensuring that the
accepted suggestions are easy better understood and consequently
simpler to implement. Therefore, I fortunately have notable experience
in the past month or so with the issue filing side of Github,
knowledge that I would definitely be interested in passing on. I am
considering writing a comprehensive multi-part guide about filing
issues about NVDA on the Github tracker and other less emphasized and
unmentioned essentials you may want to keep in mind while doing the
same in the form of a blog post on my personal blog (Hiking Across
Horizons - bhavyashah125.wordpress.com). Unfortunately, I will not be
able to get to this blog post idea till the 27th September at least
due to upcoming academic commitments, so please expect to hear from me
in this regard post that date, hopefully. Just thought I'd give a
heads-up.
Thanks.

On 9/6/17, Brian's Mail list account via Groups.Io
<bglists=blueyonder.co.uk@groups.io> wrote:
It did not work in firefox either, I think short fragments of the log in the

body are OK its other files that you really need to attach in case they get

corrupted.
It seems to me that the browse, um does not browse ..!
Brian

bglists@blueyonder.co.uk
Sent via blueyonder.
Please address personal email to:-
briang1@blueyonder.co.uk, putting 'Brian Gaff'
in the display name field.
----- Original Message -----
From: "Sarah k Alawami" <marrie12@gmail.com>
To: <nvda@nvda.groups.io>
Sent: Wednesday, September 06, 2017 5:31 AM
Subject: Re: [nvda] Github


How odd. What shoudl happen si syou hit brows and the file dialogue shoudl
appear, it does under safari. Try chrome maybe and see if that works and or

firefox or edge?

Good luck.
On Sep 5, 2017, at 10:21 AM, Cearbhall O'Meadhra
<cearbhall.omeadhra@blbc.ie> wrote:

Quentin,

Thanks for this excellent explanation!

I am being asked to attach the actual text file to a new issue rather than

simply pasting in the contents of the log file, for instance . The problem

is that I cannot get any option to attach a file when I clicked on the
“browse” button. It would be a great help if you could explain how to
attach a file using NVDA.

All the best,

Cearbhall

m +353 (0)833323487 Ph: _353 (0)1-2864623 e: cearbhall.omeadhra@blbc.ie
<mailto:cearbhall.omeadhra@blbc.ie>




From: nvda@nvda.groups.io <mailto:nvda@nvda.groups.io>
[mailto:nvda@nvda.groups.io <mailto:nvda@nvda.groups.io>] On Behalf Of
Quentin Christensen
Sent: Monday, September 4, 2017 4:59 AM
To: nvda@nvda.groups.io <mailto:nvda@nvda.groups.io>
Subject: Re: [nvda] Github

As mentioned, if you want to create a ticket, submit an issue or generally

report something that isn't working / could work better / should be
implemented etc, what you want to do is create a new issue. The link to
the issues section is https://github.com/nvaccess/nvda/issues
<https://github.com/nvaccess/nvda/issues>

Unless you are writing code yourself, you can mostly ignore the other
sections (code, pull requests, projects, etc).

Ideally, it's worth jumping to the SECOND edit box on that page to search

for the issue you want to report. (the first one searches code and other

things, you want to search issues). So, if someone reported a problem
with footnotes in Word 2016 for instance, I'd search for "word 2016
footnotes" or similar in that second edit box. There are two types of
issues, open and closed. Open issues are either new issues that haven't
been triaged yet (that is, no one has looked at them to see how serious
they are, whether the issue has already been reported etc), or issues
which are being worked on, or waiting to be worked on. Closed issues are

issues which have either been fixed, or which are duplicates of other
issues, or sometimes things which can't or won't be fixed. If the problem

with footnotes is that you want them to appear at the top of the page for

instance, then that isn't something related to NVDA. That's a feature
request for Word itself and you'd need to submit that to Microsoft.

To create a new issue, there is a "new issue" button, you can jump
straight there with https://github.com/nvaccess/nvda/issues/new
<https://github.com/nvaccess/nvda/issues/new>

When you create a new issue, there is a block of text in the "comment"
prompting you for the kinds of information that are useful in diagnosing
the issue. Please try and include: steps to reproduce the issue, attach
any files which might help (eg if Word crashes every time you try and
check formatting in this particular file, if you can share it, that would

help), what should happen and what actually happens, and your system
configuration (Windows version, application version, NVDA version and
whether installed or portable), and anything you've done to try and
resolve or get more information (eg tried different version of NVDA or
other program). Don't stress if you don't have every piece of that
information or if you aren't sure if the issue has been filed before.
When someone goes to triage the issue, they will ask for more information

if needed. If the issue has been filed previously, they will link to it
(and likely close the duplicate issue you created).

If you do have any more questions, please feel free to ask.

Kind regards

Quentin.



On Mon, Sep 4, 2017 at 2:40 AM, Lino Morales <linomorales001@gmail.com
<mailto:linomorales001@gmail.com>> wrote:
Good point sir. Ive seen Get Hub's pages in the past and its confusing as

heck.


On 9/3/2017 7:34 AM, Gene wrote:
I just looked at the Github NVDA part of the site. I haven't signed up
yet but it looks easy to do so and to create a pull request, which I
assume is what is generally referred to on this list as a ticket. But
many people may find the page confusing. Is there a way that some sort of

short help information can be inserted after the navigation links on the
page, instructing people what to do to create what are called tickets,
perhaps also how to search for tickets and how to create an account? If
tickets are desired from the widest variety of users, this process should

be somehow explained and done so in a place that those wishing to create
tickets will be likely to see the explanation.

Gene




--
Quentin Christensen
Training and Support Manager

Official NVDA Training modules and expert certification now available:
http://www.nvaccess.org/shop/ <http://www.nvaccess.org/shop/>

www.nvaccess.org <http://www.nvaccess.org/>
Facebook: http://www.facebook.com/NVAccess
<http://www.facebook.com/NVAccess>
Twitter: @NVAccess





--
Best Regards
Bhavya Shah

Blogger at Hiking Across Horizons: https://bhavyashah125.wordpress.com/

Contacting Me
E-mail Address: bhavya.shah125@gmail.com
Follow me on Twitter @BhavyaShah125 or www.twitter.com/BhavyaShah125
Mobile Number: +91 7506221750

Join nvda@nvda.groups.io to automatically receive all group messages.