Make bug report URL unset by default
There are still many issues [1, 2, 3 and more] being reported on the
Gerrit issue tracker that are not related to Gerrit at all. These are
most likely from users who have blindly clicked through from a Gerrit
site that is installed with the defaults.
The default URL makes sense on gerrit-review.googlesource.com because
it's most likely that users do actually want to report a bug on Gerrit
itself.
However for most other cases, many users are going to assume that it
links to the issue tracker for the project(s) that is/are being reviewed.
As an example of this, we see quite a lot of issues being reported from
the cyanogenmod review site [4] and the Android open source project's
review site [5]. Both of those are set up with the default URL.
Instead of defaulting to the Gerrit issue tracker, leave the bug report
URL unset if not explicitly specified in the config.
This change effects all installations, newly initialized or already
existing.
The site configuration for gerrit-review.googlesource.com will need to
be updated to explicitly configure the bug report URL.
[1] http://code.google.com/p/gerrit/issues/detail?id=3037
[2] http://code.google.com/p/gerrit/issues/detail?id=3036
[3] http://code.google.com/p/gerrit/issues/detail?id=3028
[4] http://review.cyanogenmod.org/
[5] https://android-review.googlesource.com/
Change-Id: I5c87d456868c37d9bf4cf42dc2ec93beab3444c4
diff --git a/Documentation/config-gerrit.txt b/Documentation/config-gerrit.txt
index 8e47402..3b8d26f 100644
--- a/Documentation/config-gerrit.txt
+++ b/Documentation/config-gerrit.txt
@@ -1537,15 +1537,17 @@
[[gerrit.reportBugUrl]]gerrit.reportBugUrl::
+
-URL to direct users to when they need to report a bug about the
-Gerrit service. By default this links to the upstream Gerrit
-Code Review's own bug tracker but could be directed to the system
-administrator's ticket queue.
+URL to direct users to when they need to report a bug.
++
+By default unset, meaning no bug report URL will be displayed. Administrators
+should set this to the URL of their issue tracker, if necessary.
[[gerrit.reportBugText]]gerrit.reportBugText::
+
Text to be displayed in the link to the bug report URL.
+
+Only used when `gerrit.reportBugUrl` is set.
++
Defaults to "Report Bug".
[[gerrit.changeScreen]]gerrit.changeScreen::
