#685 Improve Bugzilla instructions
Opened 6 months ago by adamwill. Modified 3 months ago

This is an idea from the F35 QA Retrospective, particularly from @ahmedalmeleh 's feedback (thanks Ahmed!)

Ahmed said he found it challenging to get used to using Bugzilla. I had a look, and it does seem like there's room for improvement here. Both the wiki and docs.fp.o welcome pages only provide a passing reference and a link to https://fedoraproject.org/wiki/Bugs_and_feature_requests , which works...I would say okay but not great as a "new user's guide to Bugzilla" page. (It's covering several different jobs).

So, this ticket is to see if we can improve that situation, either by revising the page or replacing/supplementing it, or something along those lines. @bcotton said he was interested in working on this, so I'll assign it to him; @sumantrom may well be interested too, so I'll tag him.

@ahmedalmeleh , a question - did you find the https://fedoraproject.org/wiki/Bugs_and_feature_requests page , or not? If you did find it, how helpful was it? Do you have any ideas about how to improve it? Thanks!


This will be a good December quiet time project for me, so if anyone has things that they wish were documented, please comment on this issue.

I didn't even know it existed.

On Thu, 2 Dec 2021 at 22:26, Adam Williamson pagure@pagure.io wrote:

adamwill reported a new issue against the project: fedora-qa that you
are following:
``
This is an idea from the F35 QA Retrospective, particularly
from @ahmedalmeleh 's feedback (thanks Ahmed!)

Ahmed said he found it challenging to get used to using Bugzilla. I had a
look, and it does seem like there's room for improvement here. Both the
wiki and docs.fp.o welcome pages only provide
a passing reference and a link to
https://fedoraproject.org/wiki/Bugs_and_feature_requests , which
works...I would say okay but not great as a "new user's guide to
Bugzilla" page. (It's covering several different jobs).

So, this ticket is to see if we can improve that situation, either by
revising the page or replacing/supplementing it, or something along those
lines. @bcotton said he was interested in working on this, so I'll assign
it to him; @sumantrom may well be interested too, so I'll tag him.

@ahmedalmeleh , a question - did you find the
https://fedoraproject.org/wiki/Bugs_and_feature_requests page , or not?
If you did find it, how helpful was it? Do you have any ideas about how to
improve it? Thanks!
``

To reply, visit the link below or just reply to this email
https://pagure.io/fedora-qa/issue/685

Notes to self:

  • Include marking bugs as blocking others

@ahmedalmeleh thanks! so now you've seen it, do you think it would've helped if you had found it?

may have done but with software I feel the best way I learn is through
videos. Audible learner.

On Fri, 3 Dec 2021 at 19:13, Adam Williamson pagure@pagure.io wrote:

adamwill added a new comment to an issue you are following:
@ahmedalmeleh thanks! so now you've seen it, do you think it would've helped if you had found it?

To reply, visit the link below or just reply to this email
https://pagure.io/fedora-qa/issue/685

December has come and gone, but I've done a fair amount of BZ docs work in the last few months.

Some of this is moving/editing wiki content, some is brand new. In all cases, I tried to make sure there were plenty of cross-links and that the content is easy to find.

From my perspective, we can close this ticket and additional requests can be filed as new issues against the Quick Docs or Package Maintainer docs. (If something doesn't quite fit either one, email me directly or file an issue in the pgm_docs repo.

Login to comment on this ticket.

Metadata