quick-docs/modules/ROOT/pages/bugzilla-an-introduction.adoc

= Using Bugzilla
Ben Cotton
:revnumber: F36 onwards
:revdate: 2024-01-18
:category: Troubleshooting
:tags: How-to, Bugzilla  
:page-aliases: bugzilla/index.adoc


Fedora uses https://bugzilla.redhat.com[Red Hat Bugzilla] for bug tracking. This page and the other pages under the "Bugs" header on the left offer some tips and guidance.

== Permissions

Any user, including "anonymous" (i.e. not logged in) users can view bugs.
(Note that some bugs or comments may be marked "private" or restricted to specific groups.
This is rare in Fedora and is generally to protect sensitive information that might be in an attachment or log snippet.)

Any logged-in user can create a bug report or add a comment to an existing bug.

The reporter or assignee of a bug can modify any field in their own bug.

== Creating an account

You must have a link:https://bugzilla.redhat.com/createaccount.cgi[Bugzilla account] to file bugs and interact with them.
Once you have created an account on Bugzilla, you can also login using your link:https://accounts.fedoraproject.org[Fedora account].
To use your FAS account to login to Bugzilla, you need to either use the same e-mail address on FAS and on Bugzilla, or if they differ, you can set the Bugzilla e-mail address in your FAS profile explicitly.

== Automatic changes

Bugzilla will automatically create links to bug reports or comments that follow the pattern "bug xxxx" or "comment xxxx".

Bugs marked as xref:bugzilla/find-duplicates.adoc[duplicate] will automatically get a comment referring to the other bug report. The other bug report will automatically get a comment indicating that another bug has been marked as a duplicate of it.

https://bodhi.fedoraproject.org[Bodhi] — the Fedora updates system — will automatically comment and change the xref:#_status[status] of associated bugs as updates move through the system.


== Status and resolution

Bugzilla uses fields called "Status" and "Resolution" to track the state of a bug report or feature request.

=== Status

The table below summarizes the statuses.
 
include::program_management::partial$bz_status.adoc[]


=== Resolution
 
The table below describes the resolutions that can apply to the _CLOSED_ status.
 
include::program_management::partial$bz_resolution.adoc[]
Add a general BZ info page 2022-03-11 16:33:59 +00:00			`= Using Bugzilla`
feat(bugzilla): note that users have to create accounts on bugzilla One cannot use FAS to create bugzilla accounts. One has to create explicit bugzilla accounts and can then use FAS to login after if the e-mail addresses are the same in both places Reference https://discussion.fedoraproject.org/t/improve-communication-page-and-bz-login-flow/93651/6 2024-01-18 11:49:27 +00:00			`Ben Cotton`
Added metadata. 2023-08-29 10:01:31 +00:00			`:revnumber: F36 onwards`
feat(bugzilla): note that users have to create accounts on bugzilla One cannot use FAS to create bugzilla accounts. One has to create explicit bugzilla accounts and can then use FAS to login after if the e-mail addresses are the same in both places Reference https://discussion.fedoraproject.org/t/improve-communication-page-and-bz-login-flow/93651/6 2024-01-18 11:49:27 +00:00			`:revdate: 2024-01-18`
Added metadata. 2023-08-29 10:01:31 +00:00			`:category: Troubleshooting`
			`:tags: How-to, Bugzilla`
Fixes page-aliases 2023-08-29 10:16:17 +00:00			`:page-aliases: bugzilla/index.adoc`
Added metadata. 2023-08-29 10:01:31 +00:00

			`Fedora uses https://bugzilla.redhat.com[Red Hat Bugzilla] for bug tracking. This page and the other pages under the "Bugs" header on the left offer some tips and guidance.`
Add a general BZ info page 2022-03-11 16:33:59 +00:00
			`== Permissions`

feat(bugzilla): note that users have to create accounts on bugzilla One cannot use FAS to create bugzilla accounts. One has to create explicit bugzilla accounts and can then use FAS to login after if the e-mail addresses are the same in both places Reference https://discussion.fedoraproject.org/t/improve-communication-page-and-bz-login-flow/93651/6 2024-01-18 11:49:27 +00:00			`Any user, including "anonymous" (i.e. not logged in) users can view bugs.`
			`(Note that some bugs or comments may be marked "private" or restricted to specific groups.`
			`This is rare in Fedora and is generally to protect sensitive information that might be in an attachment or log snippet.)`
Add a general BZ info page 2022-03-11 16:33:59 +00:00
Added metadata. 2023-08-29 10:01:31 +00:00			`Any logged-in user can create a bug report or add a comment to an existing bug.`
Add a general BZ info page 2022-03-11 16:33:59 +00:00
			`The reporter or assignee of a bug can modify any field in their own bug.`

feat(bugzilla): note that users have to create accounts on bugzilla One cannot use FAS to create bugzilla accounts. One has to create explicit bugzilla accounts and can then use FAS to login after if the e-mail addresses are the same in both places Reference https://discussion.fedoraproject.org/t/improve-communication-page-and-bz-login-flow/93651/6 2024-01-18 11:49:27 +00:00			`== Creating an account`

			`You must have a link:https://bugzilla.redhat.com/createaccount.cgi[Bugzilla account] to file bugs and interact with them.`
feat(bugzilla): note that bugzilla email can be set in FAS 2024-01-18 14:11:02 +00:00			`Once you have created an account on Bugzilla, you can also login using your link:https://accounts.fedoraproject.org[Fedora account].`
			`To use your FAS account to login to Bugzilla, you need to either use the same e-mail address on FAS and on Bugzilla, or if they differ, you can set the Bugzilla e-mail address in your FAS profile explicitly.`
Added metadata. 2023-08-29 10:01:31 +00:00
Add a general BZ info page 2022-03-11 16:33:59 +00:00			`== Automatic changes`

Added metadata. 2023-08-29 10:01:31 +00:00			`Bugzilla will automatically create links to bug reports or comments that follow the pattern "bug xxxx" or "comment xxxx".`
Add a general BZ info page 2022-03-11 16:33:59 +00:00
Added metadata. 2023-08-29 10:01:31 +00:00			`Bugs marked as xref:bugzilla/find-duplicates.adoc[duplicate] will automatically get a comment referring to the other bug report. The other bug report will automatically get a comment indicating that another bug has been marked as a duplicate of it.`

			`https://bodhi.fedoraproject.org[Bodhi] — the Fedora updates system — will automatically comment and change the xref:#_status[status] of associated bugs as updates move through the system.`
Add a general BZ info page 2022-03-11 16:33:59 +00:00

			`== Status and resolution`

			`Bugzilla uses fields called "Status" and "Resolution" to track the state of a bug report or feature request.`

			`=== Status`

			`The table below summarizes the statuses.`

			`include::program_management::partial$bz_status.adoc[]`

Added metadata. 2023-08-29 10:01:31 +00:00
Add a general BZ info page 2022-03-11 16:33:59 +00:00			`=== Resolution`

			`The table below describes the resolutions that can apply to the _CLOSED_ status.`

			`include::program_management::partial$bz_resolution.adoc[]`