How to file a bug
The purpose of this document is to give step by step instructions on filing bugs in Fedora.
A software bug does not necessarily need to be a software crash. Any undesired behaviour noticed in software should be filed as a bug. The package maintainer can then look at the bug report and decide the best course of action.
*Everyone should file bugs*: All users are encouraged to file any bugs they run into.
Bug filing is not limited to only software developers.
There are a few terms that are commonly used in this document:
*Bug*: A bug is any behaviour in a software that appears unexpected/undesired.
*Bug tracker*: The Fedora bug tracking system at https://bugzilla.redhat.com.
*Package*: Each software that is available in Fedora has a formal package name that is used by the bug tracker and other infrastructure tools.
Packages can be searched using the https://src.fedoraproject.org/[Fedora dist-git].
*Maintainer*: A body of volunteers that takes care of the software packages provided in Fedora.
These are referred to as "package maintainers".
They keep track of bugs, help with issues, and generally act as middlemen between the developers of the software and Fedora users.
*QA*: Quality assurance is the process of ensuring that the software works as intended.
*Bodhi*: The https://bodhi.fedoraproject.org[Fedora QA Web Application].
Before filing a bug
Step 1: Check for the latest version
As bugs are reported and fixed, developers collect a set of fixes and periodically release improved versions of their software. So, before reporting an issue, it is useful to check if you are using the latest version of a software. The simplest way to get the latest version of software in Fedora is to regularly update your system. Users of Gnome/KDE and other desktop environments can use their default applications to do so. These periodically check for updates and notify users. You can also use the default package manager `dnf` to check and update your system. Only users with administrator privileges can do so:
$ sudo dnf update --refresh
Step 2: Check for already filed bugs
If you are using the latest version of the software available in Fedora, then it is likely that the bug has either not been reported, or has been reported but a fix has not yet been released. So, it is useful to search the list of already reported bugs before filing a new report. The https://packages.fedoraproject.org/[Fedora Packages Web application] lists the currently reported bugs for all packages. There is also a convenient shortcut that can be used.
https://bugz.fedoraproject.org/<package name>
Here, the `package name` must be the formal name of the package.