Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 13 additions & 15 deletions content/participate/report-issue.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -10,16 +10,16 @@ tags:

== How-To Report an Issue

Jenkins JIRA is an issue tracker, not a support site.
If you need assistance or have general questions, visit us link:/chat/[in chat], email one of the link:/mailing-lists[mailing lists], or post on the https://community.jenkins.io/[community forum].
The Jenkins issues tracker is for enhancements and bugs, not a support site.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The Jenkins issues tracker is for enhancements and bugs, not a support site.
The Jenkins issue tracker is for enhancements and bugs, not a support site.

If you need assistance or have general questions, post on the https://community.jenkins.io/[community forum], visit us link:/chat/[in chat], or email one of the link:/mailing-lists[mailing lists].

[[Howtoreportanissue-Beforecreatinganissue]]
== Before creating an issue

First, *identify the location of the issue*.
Are you reporting an issue in Jenkins itself or one of its plugins?
We document all the issues in Jenkins on link:https://issues.jenkins.io/[JIRA].
Plugins may use JIRA or Github for issue tracking, see <<Howtoreportanissue-Creatingtheissue,Creating the Issue>> for details.
We document all the issues in Jenkins on link:https://github.com/jenkinsci/jenkins/issues[GitHub].
Plugins may use Jira or Github for issue tracking, see <<Howtoreportanissue-Creatingtheissue,Creating the Issue>> for details.
If you are reporting an issue with the jenkins.io site, please create an issue in our link:https://github.com/jenkins-infra/jenkins.io/issues[GitHub issue tracker].

After that, determine what kind of issue it is. There are three main types:
Expand All @@ -30,7 +30,7 @@ whose use is explained on this page:
functionality should be added.
* *Vulnerabilities*: link:/security/reporting/[Security related issues in Jenkins]

Other types (_Patch_, _Task_) are not used in JIRA.
Other types (_Patch_, _Task_) are not used in Jira.
Neither will be explained here.
If you want to propose a patch, create an issue using one of the 3 types above, and then create a pull request on GitHub link:https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request[as explained here].
Report issues with infrastructure services hosted by the Jenkins project (jenkins.io, accounts.jenkins.io, etc.) at link:https://github.com/jenkins-infra/helpdesk/issues/[the dedicated help desk].
Expand All @@ -41,16 +41,14 @@ Report issues with infrastructure services hosted by the Jenkins project (jenkin
* First, *search for the error message or general problem description*.
This can help you find solutions if it's actually e.g. a configuration
problem, or point you to earlier reports in case you're not the first
one experiencing this problem. You can
http://issues.jenkins.io/secure/IssueNavigator.jspa[use the search
in the issue tracker], or use web search.
one experiencing this problem. You can search the issue tracker, or use web search.
https://stackoverflow.com/tags/jenkins[Stack Overflow] may also be a
good place to search. Any results will often point you to earlier issue
reports if it's really a bug. You can then _watch them_ and _vote for
https://stackoverflow.com/tags/jenkins[Stack Overflow] may also be a
good place to search.
Any results will often point you to earlier issue reports if it's really a bug.
You can then _watch them_ and _vote for them_ in JIRA, or subscribe to notifications in Github Issues.
You can then _subscribe_ and _up vote_ (thumbs up reaction) to the issue.
Voting helps us determine the impact of bugs and prioritize them.
If you have doubts that the problem you're experiencing is the exact same one as you found, and prefer to file a new issue, be sure to mention the one(s) you found in the description.
issue (and mention the one(s) you found in the description)._
Expand All @@ -74,7 +72,7 @@ If you're still unable to resolve the problem, and cannot find existing issue re

* *Check newer versions of Jenkins or the plugin* for this feature.
They may have the feature already!
* *Search JIRA or Github Issues for existing requests* for this feature.
* *Search the issue tracker for existing requests* for this feature.
You can then _watch and vote for them_.
Voting helps us determine the demand for requests and prioritize them, so it's in your interest to actually find these rather than creating a duplicate.

Expand All @@ -90,24 +88,24 @@ times with only a few watchers each.

[[Howtoreportanissue-Creatingtheissue]]
== Creating the issue
If you are reporting an issue in Jenkins, then you'll have to report it on link:https://issues.jenkins.io/[JIRA].
If you are reporting an issue in Jenkins, then you'll have to report it on link:https://github.com/jenkinsci/jenkins/issues[GitHub].
However *if the issue you're reporting is in one of Jenkins' plugins*, you'll have to follow these steps:

* Open the link:https://plugins.jenkins.io/[Plugin Site].
* Search for the Plugin and open its page.
* Click the *Report an issue* link in the *Links* section on the right side of the
plugin page.
** After selecting the link, if you end up on JIRA follow the instructions on link:/participate/report-issue/#reporting-issue-on-jira[Reporting an Issue in JIRA].
** After selecting the link, if you end up on Jira follow the instructions on link:/participate/report-issue/#reporting-issue-on-jira[Reporting an Issue in Jira].
** After selecting the link, if you end up on Github follow the instructions on link:/participate/report-issue/#reporting-issue-on-github[Reporting an Issue on Github].


=== Reporting an issue on JIRA
=== Reporting an issue on Jira
You need to https://accounts.jenkins.io/[register an account] if you
haven't already. Then, just select *Create Issue* on
https://issues.jenkins.io/secure/Dashboard.jspa[the JIRA home page].
https://issues.jenkins.io/secure/Dashboard.jspa[the Jira home page].

* For *Project* select:
** _Jenkins_ for general issues with Jenkins,
** _Jenkins_ for general issues with plugins that use Jira for issue tracking,
** _Security Issues_ if you want to report a security issue privately
* For _Infrastructure_, if you're reporting a bug with link:/projects/infrastructure/[a Jenkins service run by the Jenkins project], open an issue in the https://github.com/jenkins-infra/helpdesk/issues/new/choose[dedicated helpdesk on Github].
* Enter a short but meaningful description of your problem as *Summary*.
Expand Down
1 change: 0 additions & 1 deletion content/support.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,6 @@ For real-time discussions and quick questions:
For demonstrable bug reports and feature requests:

* link:/participate/report-issue/[How to report an issue] - Guidelines for effective issue reporting
* link:https://issues.jenkins.io/[Jenkins Issue Tracker] - Report bugs or request features

=== Infrastructure Helpdesk

Expand Down