diff --git a/BugReportingGuide.md b/BugReportingGuide.md new file mode 100644 index 00000000..8a4193ff --- /dev/null +++ b/BugReportingGuide.md @@ -0,0 +1,30 @@ +--- +layout: wiki +title: BugReportingGuide +permalink: /wiki/BugReportingGuide/ +--- + +Bug Reporting Guide +=================== + +One of the most important contribution task is reporting the bugs you have found. + +All bugs and suggestions should be reported to one of our [mailing list](/wiki/QubesLists). We decided that at this stage access to the wiki and the [​ticketing system](https://qubes-os.org/trac/report/3) should be limited and per-invitation only, and generally granted to those people who actually can first demonstrate that they are capable of contributing something useful to the project. Our main goal is to build a quality product, and this has a priority over building "a large community". + +So if you have not allowed to file new tickets You should follow these guide lines: + +1. Search the issue tracker to see if your issue is already there - if so please cite the issue \# in any comments you post. + - [​Simple search](https://qubes-os.org/trac/search) + - [​Advanced search](https://qubes-os.org/trac/query) + +1. Search the [mailing lists](/wiki/QubesLists) to see if your issue is already discussed - if so, add your comments to the existing thread. + +1. If your problem seems to be a new one report it: + - as a mail - with a clear specific subject like "bug report: \" + - include steps to reproduce the problem if possible, and relevant log files (if you know); + - if its a hardware related issue include your [HCL](/wiki/HCL) Support files as well. + +1. Qubes core [developers](/wiki/QubesDevelopers) may ask you additional questions - please do follow up. + +1. If the issue can be validated as a definite bug then he enters it into the [​issue tracker](https://qubes-os.org/trac/report/3). +