diff --git a/src/docs/contributor/bug_reports.diviner b/src/docs/contributor/bug_reports.diviner --- a/src/docs/contributor/bug_reports.diviner +++ b/src/docs/contributor/bug_reports.diviner @@ -3,32 +3,33 @@ Describes how to file an effective Phabricator bug report. -Include Reproduction Steps! -=========================== +Level Requirements +================== + +We accept bug reports through two channels: paid support and community +support. -IMPORTANT: When filing a bug report, you **MUST** include reproduction -instructions. We can not help fix bugs we can not reproduce, and will not -accept reports which omit reproduction instructions. +If you are a paying customer, use the +[[ https://admin.phacility.com/u/support | Support Channel ]] for your account +to report bugs. This document may help you file reports which we can resolve +more quickly, but you do not need to read it or follow the guidelines. -For help, see @{article:Providing Reproduction Steps}. +Other users can follow the guidelines in this document to file bug reports on +the community forum. Overview ======== -Found a bug with Phabricator? Let us know! This article describes how to file -an effective bug report so we can get your issue fixed or help you work around -it. +This article describes how to file an effective Phabricator bug report. The most important things to do are: - check the list of common fixes below; - make sure Phabricator is up to date; - make sure we support your setup; - - gather debugging information; - - explain how to reproduce the issue; and - - create a task in - [[ http://secure.phabricator.com/u/newbug/ | Maniphest ]]. + - gather debugging information; and + - explain how to reproduce the issue. The rest of this article walks through these points in detail. @@ -139,8 +140,8 @@ The most important part of your report content is instructions on how to reproduce the issue. What did you do? If you do it again, does it still break? -Does it depend on a specific browser? Can you reproduce the issue on -`secure.phabricator.com`? +Does it depend on a specific browser? Can you reproduce the issue on a free +instance on `admin.phabricator.com`? It is nearly impossible for us to resolve many issues if we can not reproduce them. We will not accept reports which do not contain the information required @@ -149,26 +150,18 @@ For help, see @{article:Providing Reproduction Steps}. -For Open Source Users -===================== +File a Bug Report +================= -If you're up to date, supported, have collected information about the problem, -and have the best reproduction instructions you can come up with, you're ready -to file an issue. +If you're up to date, have collected information about the problem, and have +the best reproduction instructions you can come up with, you're ready +to file a report. -It is **particularly critical** that you include reproduction steps. We will -not accept reports which describe issues we can not reproduce. - -(NOTE) https://discourse.phabricator-community.org/c/bug +It is **particularly critical** that you include reproduction steps. +You can file a report on the community forum, here: -For Phacility Customers -======================= - -If you've encountered a bug via a Phacility instance or have a paid support -contract with Phacility, you can find more information on how to get help via -[[ https://admin.phacility.com/book/phacility/article/support/ | Phacility -Support ]]. +(NOTE) https://discourse.phabricator-community.org/c/bug Next Steps