2013-06-15 05:07:40 -04:00
|
|
|
---
|
2015-04-10 16:17:45 -04:00
|
|
|
layout: doc
|
2015-09-25 23:16:18 -04:00
|
|
|
title: Reporting Bugs
|
2015-10-11 03:04:59 -04:00
|
|
|
permalink: /en/doc/reporting-bugs/
|
2015-09-25 23:16:18 -04:00
|
|
|
redirect_from:
|
2015-10-11 03:04:59 -04:00
|
|
|
- /doc/reporting-bugs/
|
2015-09-25 23:16:18 -04:00
|
|
|
- "/doc/BugReportingGuide/"
|
|
|
|
|
- "/wiki/BugReportingGuide/"
|
2013-06-15 05:07:40 -04:00
|
|
|
---
|
|
|
|
|
|
|
|
|
|
Bug Reporting Guide
|
|
|
|
|
===================
|
|
|
|
|
|
|
|
|
|
One of the most important contribution task is reporting the bugs you have found.
|
|
|
|
|
|
2015-05-03 19:45:52 -04:00
|
|
|
Asking a Question
|
|
|
|
|
-----------------
|
2013-06-15 05:07:40 -04:00
|
|
|
|
2015-05-03 19:45:52 -04:00
|
|
|
Before you ask, do some searching and reading. Check [the
|
|
|
|
|
docs](https://www.qubes-os.org/doc/), Google, GitHub, and StackOverflow. If
|
|
|
|
|
your question is something that has been answered many times before, the
|
|
|
|
|
project maintainers might be tired of repeating themselves.
|
2013-06-15 05:07:40 -04:00
|
|
|
|
2015-05-03 19:45:52 -04:00
|
|
|
Whenever possible, ask your question on the Qubes mailing list which is
|
|
|
|
|
located [here](https://groups.google.com/forum/#!forum/qubes-users). This
|
|
|
|
|
allows anyone to answer and makes the answer available for the next person
|
|
|
|
|
with the same question.
|
2013-06-15 05:07:40 -04:00
|
|
|
|
2015-05-03 19:45:52 -04:00
|
|
|
Submitting a Bug Report (or "Issue")
|
|
|
|
|
------------------------------------
|
2013-06-15 05:07:40 -04:00
|
|
|
|
2015-07-23 07:19:16 -04:00
|
|
|
On GitHub, "Bug Reports" are called "Issues."
|
2013-06-15 05:07:40 -04:00
|
|
|
|
2015-05-03 19:45:52 -04:00
|
|
|
Issues can be submitted to the Qubes project located at
|
|
|
|
|
[https://github.com/QubesOS/qubes-issues](https://github.com/QubesOS/qubes-issues).
|
2013-06-15 05:07:40 -04:00
|
|
|
|
2015-05-03 19:45:52 -04:00
|
|
|
### Has This Been Asked Before?
|
2013-06-15 05:07:40 -04:00
|
|
|
|
2015-05-03 19:45:52 -04:00
|
|
|
Before you submit a bug report, you should search existing issues. Be sure
|
|
|
|
|
to check both currently open issues, as well as issues that are already
|
|
|
|
|
closed. If you find an issue that seems to be similar to yours, read
|
|
|
|
|
through it.
|
|
|
|
|
|
|
|
|
|
If this issue is the same as yours, you can comment with additional
|
|
|
|
|
information to help the maintainer debug it. Adding a comment will
|
|
|
|
|
subscribe you to email notifications, which can be helpful in getting
|
|
|
|
|
important updates regarding the issue. If you don't have anything to add
|
|
|
|
|
but still want to receive email updates, you can click the "watch" button
|
|
|
|
|
at the bottom of the comments.
|
|
|
|
|
|
|
|
|
|
### Nope, Hasn't Been Asked Before
|
|
|
|
|
|
|
|
|
|
If you can't find anything in the existing issues, don't be shy about
|
|
|
|
|
filing a new one.
|
|
|
|
|
|
|
|
|
|
You should be sure to include the version the project, as well as versions
|
|
|
|
|
of related software. For example, be sure to include the Qubes release
|
|
|
|
|
version (R2, R3) and specific version numbers of package causing problems
|
2015-07-23 07:19:16 -04:00
|
|
|
(if known).
|
2015-05-03 19:45:52 -04:00
|
|
|
If your issue is related to hardware, provide as many details as possible
|
|
|
|
|
about the hardware, which could include using commandline tools such as
|
2015-07-23 07:19:16 -04:00
|
|
|
`lspci`.
|
2015-05-03 19:45:52 -04:00
|
|
|
|
|
|
|
|
Project maintainers really appreciate thorough explanations. It usually
|
|
|
|
|
helps them address the problem more quickly, so everyone wins!
|
|
|
|
|
|
|
|
|
|
Improving the Code
|
|
|
|
|
------------------
|
|
|
|
|
|
|
|
|
|
The best way is to "Fork" the repo on GitHub. This will create a copy of
|
|
|
|
|
the repo on your GitHub account.
|
|
|
|
|
|
|
|
|
|
Before you set out to improve the code, you should have a focused idea in
|
|
|
|
|
mind of what you want to do.
|
|
|
|
|
|
|
|
|
|
Each commit should do one thing, and each PR should be one specific
|
|
|
|
|
improvement. Each PR needs to be signed.
|
|
|
|
|
|
|
|
|
|
* [How can I contribute to the Qubes Project?](https://www.qubes-os.org/doc/ContributingHowto/)
|
|
|
|
|
* [Developer Documentation](https://www.qubes-os.org/doc/)
|
|
|
|
|
* [Package Release Workflow](https://github.com/QubesOS/qubes-builder/blob/master/doc/ReleaseManagerWorkflow.md)
|
