jenkinsci / atlassian-jira-software-cloud-plugin

Atlassian Jira Software Cloud Plugin
https://plugins.jenkins.io/atlassian-jira-software-cloud/
Apache License 2.0
43 stars 46 forks source link

Missing details for Jenkins integration and Atlassian REST API #125

Open marcellomonachesi-tomtom opened 4 months ago

marcellomonachesi-tomtom commented 4 months ago

Describe your use-case which is not covered by existing documentation.

What is the difference between this plugin and Jenkins Jira Plugin? They both can connect to Jira Cloud.

The doc of this plugin says: "Used together, the Atlassian Jira Software Cloud plugin for Jenkins and the Jenkins for Jira app for Jira provide a free, secure, and reliable way to connect your Jenkins server, running behind the firewall, with either Jira Software Cloud or Jira Service Management Cloud."

The doc of Jenkins Jira Plugin says: "This plugin integrates with Jenkins the Atlassian Jira Software (both Cloud and Server versions)."

The second question is: does this plugin offer methods to manipulate tickets instead of raw API calls? For example, JIRA Pipeline Steps plugin, which provides methods like jiraGetIssueTransitions, jiraLinkIssues, jiraNewIssue, etc.. If it doesn't provide methods, how to call Jira Cloud API?

Reference any relevant documentation, other materials or issues/pull requests that can be used for inspiration.

I don't know which relevant docs can be used for inspiration. However, a table highlighting the differences with other major Jenkins plugins would be useful.

Are you interested in contributing to the documentation?

No response