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.

• Moved Bug Status Workflow page to maintainer docs
• Moved "Finding the Correct Component" to Quick Docs
• Moved "Finding Duplicates" to Quick Docs
• Added pages on reporting spam and managing email notifications to Quick Docs
• Moved much of the Understanding Bugzilla content to Quick Docs

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.

Thanks a lot, retrospectively, for that work, Ben. :) As Ben has moved on to pastures Docker-ier, and Bugzilla is likely going away in the medium term, let's say this is good enough.