@recaptime-dev's working patches + fork for Phorge, a community fork of Phabricator. (Upstream dev and stable branches are at upstream/main and upstream/stable respectively.)
hq.recaptime.dev/wiki/Phorge
phorge
phabricator
More adjustments to bug reporting document
Summary:
Ref T12922.
- Tell customers where to go at the top.
- Fix a couple minor things (e.g., don't advise users to reproduce on `secure` anymore).
Test Plan: Read carefully.
Reviewers: chad, avivey
Reviewed By: chad, avivey
Maniphest Tasks: T12922
Differential Revision: https://secure.phabricator.com/D18236
+24
-31
+24
-31
src/docs/contributor/bug_reports.diviner
+24
-31
src/docs/contributor/bug_reports.diviner
···
3
3
4
4
Describes how to file an effective Phabricator bug report.
5
5
6
-
Include Reproduction Steps!
7
-
===========================
6
+
Level Requirements
7
+
==================
8
8
9
-
IMPORTANT: When filing a bug report, you **MUST** include reproduction
10
-
instructions. We can not help fix bugs we can not reproduce, and will not
11
-
accept reports which omit reproduction instructions.
9
+
We accept bug reports through two channels: paid support and community
10
+
support.
11
+
12
+
If you are a paying customer, use the
13
+
[[ https://admin.phacility.com/u/support | Support Channel ]] for your account
14
+
to report bugs. This document may help you file reports which we can resolve
15
+
more quickly, but you do not need to read it or follow the guidelines.
12
16
13
-
For help, see @{article:Providing Reproduction Steps}.
17
+
Other users can follow the guidelines in this document to file bug reports on
18
+
the community forum.
14
19
15
20
16
21
Overview
17
22
========
18
23
19
-
Found a bug with Phabricator? Let us know! This article describes how to file
20
-
an effective bug report so we can get your issue fixed or help you work around
21
-
it.
24
+
This article describes how to file an effective Phabricator bug report.
22
25
23
26
The most important things to do are:
24
27
25
28
- check the list of common fixes below;
26
29
- make sure Phabricator is up to date;
27
30
- make sure we support your setup;
28
-
- gather debugging information;
29
-
- explain how to reproduce the issue; and
30
-
- create a task in
31
-
[[ http://secure.phabricator.com/u/newbug/ | Maniphest ]].
31
+
- gather debugging information; and
32
+
- explain how to reproduce the issue.
32
33
33
34
The rest of this article walks through these points in detail.
34
35
···
139
140
140
141
The most important part of your report content is instructions on how to
141
142
reproduce the issue. What did you do? If you do it again, does it still break?
142
-
Does it depend on a specific browser? Can you reproduce the issue on
143
-
`secure.phabricator.com`?
143
+
Does it depend on a specific browser? Can you reproduce the issue on a free
144
+
instance on `admin.phabricator.com`?
144
145
145
146
It is nearly impossible for us to resolve many issues if we can not reproduce
146
147
them. We will not accept reports which do not contain the information required
···
149
150
For help, see @{article:Providing Reproduction Steps}.
150
151
151
152
152
-
For Open Source Users
153
-
=====================
154
-
155
-
If you're up to date, supported, have collected information about the problem,
156
-
and have the best reproduction instructions you can come up with, you're ready
157
-
to file an issue.
158
-
159
-
It is **particularly critical** that you include reproduction steps. We will
160
-
not accept reports which describe issues we can not reproduce.
153
+
File a Bug Report
154
+
=================
161
155
162
-
(NOTE) https://discourse.phabricator-community.org/c/bug
156
+
If you're up to date, have collected information about the problem, and have
157
+
the best reproduction instructions you can come up with, you're ready
158
+
to file a report.
163
159
160
+
It is **particularly critical** that you include reproduction steps.
164
161
165
-
For Phacility Customers
166
-
=======================
162
+
You can file a report on the community forum, here:
167
163
168
-
If you've encountered a bug via a Phacility instance or have a paid support
169
-
contract with Phacility, you can find more information on how to get help via
170
-
[[ https://admin.phacility.com/book/phacility/article/support/ | Phacility
171
-
Support ]].
164
+
(NOTE) https://discourse.phabricator-community.org/c/bug
172
165
173
166
174
167
Next Steps