[POLL] Do you use the its-jira plugin?

174 views
Skip to first unread message

lucamilanesio

unread,
Mar 18, 2021, 1:01:57 PM3/18/21
to Repo and Gerrit Discussion
Hi all,
if you use the its-jira plugin, or plan to use it, can you give me some input on how you discovered that it actually exist?

P.S. The poll is anonymous, so you are not required to put any personal information.

Have your say at:

Thanks for your time.
Luca.

lucamilanesio

unread,
Mar 19, 2021, 6:14:53 PM3/19/21
to Repo and Gerrit Discussion
Thanks everyone for answering on this poll request.

See below the answers to the question: "How did you hear about the its-jira integration for Gerrit?"
  • 4% = I did not know it existed, until now :-) 
  • 4% - I found it on the Gerrit plugin manager
  • 9% - I read about it on the Gerrit repo-discuss mailing list
  • 57% - I found it in the list of Gerrit plugins on the web
  • 9% - Word of mouth
  • 17% - I do not use Jira and no plans to use it
Based on the results, I may think that the ITS-Jira plugin is quite discoverable, because only 4% of the people did not know that it existed.
The top 2 ways of discovering it are:
- the list of Gerrit plugins on gerritcodereview.com (kudos to Marco and Matthias !!!)
- the mailing list

I was thinking about writing a dedicated page for the gerritcodereview.com site, 100% dedicated to Gerrit and the Issue-Tracker integration (e.g. Jira or others).
It should NOT be a detailed documentation of the plugin, because it would be stale very soon, but it would rather be a workflow-style functional view on how to use Gerrit in concert with Issue Trackers.

What do you think?

Luca.

Fabio Ponciroli

unread,
Mar 19, 2021, 6:39:18 PM3/19/21
to lucamilanesio, Repo and Gerrit Discussion
I think it makes sense, it will probably make it more discoverable via search engines in general. In fact I was expecting the main answer from the pool to be "I googled it" :P

Does it mean we intend to have a dedicated page for all the "main" plugins in future?


Luca.

--
--
To unsubscribe, email repo-discuss...@googlegroups.com
More info at http://groups.google.com/group/repo-discuss?hl=en

---
You received this message because you are subscribed to the Google Groups "Repo and Gerrit Discussion" group.
To unsubscribe from this group and stop receiving emails from it, send an email to repo-discuss...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/repo-discuss/50b714c8-c974-4a9c-9402-fd93c1ec30c3n%40googlegroups.com.

Sven Selberg

unread,
Mar 22, 2021, 5:53:46 AM3/22/21
to Repo and Gerrit Discussion
On Friday, March 19, 2021 at 11:39:18 PM UTC+1 pon...@gmail.com wrote:
Il giorno ven 19 mar 2021 alle ore 15:14 lucamilanesio <luca.mi...@gmail.com> ha scritto:


On Thursday, March 18, 2021 at 5:01:57 PM UTC lucamilanesio wrote:
Hi all,
if you use the its-jira plugin, or plan to use it, can you give me some input on how you discovered that it actually exist?

P.S. The poll is anonymous, so you are not required to put any personal information.

Have your say at:

Thanks everyone for answering on this poll request.

See below the answers to the question: "How did you hear about the its-jira integration for Gerrit?"
  • 4% = I did not know it existed, until now :-) 
  • 4% - I found it on the Gerrit plugin manager
  • 9% - I read about it on the Gerrit repo-discuss mailing list
  • 57% - I found it in the list of Gerrit plugins on the web
  • 9% - Word of mouth
  • 17% - I do not use Jira and no plans to use it
Based on the results, I may think that the ITS-Jira plugin is quite discoverable, because only 4% of the people did not know that it existed.
The top 2 ways of discovering it are:
- the list of Gerrit plugins on gerritcodereview.com (kudos to Marco and Matthias !!!)
- the mailing list

I was thinking about writing a dedicated page for the gerritcodereview.com site, 100% dedicated to Gerrit and the Issue-Tracker integration (e.g. Jira or others).
It should NOT be a detailed documentation of the plugin, because it would be stale very soon, but it would rather be a workflow-style functional view on how to use Gerrit in concert with Issue Trackers.

What do you think?

I, personally, see no benefit in adding plugin specific documentation on gerritcodereview.com other
than the current list of plugins.
The plugin list is just as easily discoverable via search engines (searching for Gerrit+Jira) and it
contains a link to the actual plugin and, as a consequence, the documentation for the plugin.
The plugin's own documentation would IMO be the correct place for such a document.

So far the homepage is a quite clean starting-point for all things Gerrit and, I would prefer if we
kept the homepage as compact as possible and not add onto it just because we can.

The core Gerrit documentation is a prime example of the fact that documentation maintenance isn't
prioritized by us (the community) and that we are better at piling on to rotting documentation than we
are at reworking it.

There is f.i. a section in the , aforementioned, core Gerrit Documentation on issue tracker integration,
WDYT.

Sven Selberg

unread,
Mar 22, 2021, 6:00:13 AM3/22/21
to Repo and Gerrit Discussion
Sorry for the late reply but I couldn't find an answer that would match "decided not to use its-jira".

Luca Milanesio

unread,
Mar 22, 2021, 7:06:53 AM3/22/21
to Sven Selberg, Luca Milanesio, Repo and Gerrit Discussion
There is a "I do not use Jira and no plans to use it” which pretty much matches it.
… or are you saying that you use Jira but you don’t like its-jira integration and used something else?

If yes, would you like to share your feedback on it?

Luca.




Thanks for your time.
Luca.

--
--
To unsubscribe, email repo-discuss...@googlegroups.com
More info at http://groups.google.com/group/repo-discuss?hl=en

---
You received this message because you are subscribed to the Google Groups "Repo and Gerrit Discussion" group.
To unsubscribe from this group and stop receiving emails from it, send an email to repo-discuss...@googlegroups.com.

Sven Selberg

unread,
Mar 22, 2021, 11:39:45 AM3/22/21
to Repo and Gerrit Discussion
On Monday, March 22, 2021 at 12:06:53 PM UTC+1 lucamilanesio wrote:

On 22 Mar 2021, at 10:00, Sven Selberg <sven.s...@axis.com> wrote:



On Thursday, March 18, 2021 at 6:01:57 PM UTC+1 lucamilanesio wrote:
Hi all,
if you use the its-jira plugin, or plan to use it, can you give me some input on how you discovered that it actually exist?

P.S. The poll is anonymous, so you are not required to put any personal information.

Have your say at:

Sorry for the late reply but I couldn't find an answer that would match "decided not to use its-jira".

There is a "I do not use Jira and no plans to use it” which pretty much matches it.

If we didn't use Jira I would obviously have chosen this option, but we do. :-)
 
… or are you saying that you use Jira but you don’t like its-jira integration and used something else?

Yes
 

If yes, would you like to share your feedback on it?

We evaluated its-jira (based on usage at previous employer and mapping with the current use-case)
and came to the conclusion that what complexity we would loose in Gerrit -> Jira integration would
be gained on the Jira end so the net benefit would be negative for us.

its-jira has a static state mapping (change -> Jira ticket) and the state that is required for closing an
issue is often more complex than a 1-to-1 with a change.
In order for the mapping to "work" we would need to create a separate issue/sub-task for each
change that is created but other states would still need human evaluation in order to close the
change, so not much would be gained for us with this approach.

its-jira (last time I checked) advertised state in Jira by adding a comment which makes it hard
to get a quick overview of the state(s) of related gerrit change(s) so that functionality wasn't
what we wanted either.


Instead we configure "trackingid"[1] and "commentlink"[2] for jira in gerrit.config.

So on the Gerrit side we have a commit-msg footer that links to Jira like:

    Solves: Jira PROJ-123

And on the Jira side we use the "Gerrit Reviews" tab from the Jira plugin jira-gerrit-plugin[3]
which is a very lightweight plugin that queries Gerrit for "tr: $JIRA-ISSUE-ID" and displays the
response in a table in the Jira UI.

Those two links are simple but extremely useful and covers most of our Gerrit -> Jira integration
needs without any overhead.

We are starting to play with the idea to have a lightweight plugin on the Gerrit side that possibly:
- Displays links to other Gerrit changes that relates to the same Jira issue(s).
- Displays Jira issue data on the change-screen
But so far that is only at the idea stage.

BR
Sven
 
[1]
[trackingid "jira"]
        system = Jira
        footer = Solves:
        match = [Jj][Ii][Rr][Aa]\\s+([A-Z][A-Z0-9]+-[0-9]+)(?:\\s|$)
[2]
[commentlink "jira"]
        match = (\\n(?:Solves|Reference):\\s*[Jj][Ii][Rr][Aa]\\s+)([A-Z][A-Z0-9]+-[0-9]+)(\\b|$)
        html = $1<a href=\"{{ jira_browse_url }}/$2\">$2</a>$3

Luca Milanesio

unread,
Mar 22, 2021, 12:13:45 PM3/22/21
to Repo and Gerrit Discussion, Luca Milanesio
That’s a nice idea, looks similar to the GitHub <-> GitHub Issues integration.

In the its-jira plugin you can also trigger actions (any ITS-Jira action) based on generic conditions on the change.
I need to explore how your use-case could be implemented easily and it would be a nice idea to report that as example configuration.


And on the Jira side we use the "Gerrit Reviews" tab from the Jira plugin jira-gerrit-plugin[3]
which is a very lightweight plugin that queries Gerrit for "tr: $JIRA-ISSUE-ID" and displays the
response in a table in the Jira UI.

Yes, if you have control over the Jira setup and you can install plugins there, that plugin gives a nice place where to display the associated changes.


Those two links are simple but extremely useful and covers most of our Gerrit -> Jira integration
needs without any overhead.

Do you also do any commit validation to make sure that people remembers to add the Jira ID in their commit footer?


We are starting to play with the idea to have a lightweight plugin on the Gerrit side that possibly:
- Displays links to other Gerrit changes that relates to the same Jira issue(s).
- Displays Jira issue data on the change-screen
But so far that is only at the idea stage.

That would be a nice addition: would you plan to make a client-side only plugin that would make the Jira API calls directly?

Thanks again for sharing your experience with the rest of the community.
Luca.

Reply all
Reply to author
Forward
0 new messages