Release Status Plugin for JIRA Originally created by Henri Yandell at SourceLabs, Inc. Download: plugin jar, peruse source zip or check out svn.

Legal bit

Released under the Apache License 2.0 and Copyright 2007-2008 Henri Yandell/SourceLabs, Inc.

This project uses the excellent famfamfam.com Silk icons.

About the plugin

A plugin that provides three portlets.

1. The first is a portlet for the JIRA dashboard that provides a status for a particular version.

   Its expected use case is for highlighting the next release of the major product(s) via a feature-list of:

   • Handy stats on the activity in the last week
   • Useful stats for due-date management
   • Information on how close the project is to release
   • Release health - will your last week's velocity see you hitting your release date
   • Useful links to the release notes and the version workload
   • Current user, all users or adaptive toggle - adaptive means that between 50% and 95% it's current user, otherwise it's all users

2. The second portlet lets you show the last N releases. Its expected to be of use to large JIRAs with many releases.

3. The third is a project panel that makes it easy to see the release history of a project. Its expected to be of use to projects that have had with many releases.

Release History

Version 2.4.2 was released on 30th of January 2008. There was one bugfix:

• RSP-71 - Nothing shows when a project has only 1 version

Version 2.4.1 was released on 28th of September 2007. There were two bugfixes, the second of which was an improvement over its fix in 2.4:

• RSP-68 - Fails to run under 3.11
• RSP-63 - No Version Description Text Causes $version.description is not a valid reference Exception

Version 2.4 was released on 4th of August 2007. There were four improvements and three bugfixes:

• RSP-56 - Show a tick or a cross if at 100% or if the release date has been missed
• RSP-57 - Need way to click on progress bar when it's small
• RSP-58 - 'smart' default for currentuser/all
• RSP-60 - Random project Release Status
• RSP-61 - Right arrow is not vertically aligned to top when there's no emoticon
• RSP-62 - Velocity Error with isVersionOverDue in Jira 3.10
• RSP-63 - No Version Description Text Causes $version.description is not a valid reference Exception

Version 2.3.1 was released on 28th of July 2007. There were two bugfixes:

• RSP-55 - Release Status Portlet generates exceptions under Jira 3.10
• RSP-7 - Releases project tab links to unresolved issues, not all issues

Version 2.3 was released on 19th of April 2007. There were four bugfixes:

• Latest Releases portlet was not showing more than one release for the same day
• Release Status portlet links were not changing under current user mode
• The Release Status portlet now ignores archived versions that are not released when deciding on a default version for a project
• The direct link for the Release Status portlet was failing with an NPE when the portlet was showing just the one version

Version 2.2 was released on 13th of April 2007. It provided various bugfixes and small feature enhancements, including:

• The Release Status portlet allows a project to be specified to show the status of all releases in that JIRA project
• Tooltips are now escaped in case descriptions contain HTML
• The Latest Releases portlet allows Future Releases and/or Overdue Releases to be shown
• User's permissions to see projects is better heeded by both the Release Status portlet and the Latest Releases portlet
• The Release Status portlet shows the total number of issues in a project
• The number of issues In Progress is shown
• Anonymous viewing is better

Version 2.1 was released on 27th of March 2007. Its main focus was a beefed up release status portlet with:

• Now supports more than one version, allowing you to create version chains
• The new top bar containing:
  • project name
  • current-user/all-users toggle
  • links to the release notes and the version workload report

Version 2.0 was released on 17th of March 2007. It added the latest releases portlet and the releases project panel.

Version 1.0 was released on 16th of March 2007. It just contained the release status portlet.

Installing & Using

Install the plugin by downloading the plugin jar, place it in your $JIRA/WEB-INF/lib/ and giving your JIRA a restart.

Once it's installed you can add the to your dashboard by selecting the Release Status portlet and the Latest Releases portlet. The Releases project tab is automatically added to your browse project pages. Please follow the instructions from Atlassian for configuring your personal dashboard or the default dashboard.

The source is available for perusing by downloading the source zip and unpacking.

Complaints, bugs, ideas...

Please mail these to me at bayard-at-generationjava.com, or add them as comments to the JIRA plugin page.

Screenshots

To get you salivating, here's the Release Status portlet showing a happy project which is very close to release:

and here the Release Status portlet shows a project for the current user that is in its early days and still creating new issues:

The screenshot for the Latest Releases portlet should be no surprise:

and the screenshot for the Releases project panel will hopefully spark interest:

Lastly, a rather big image. It's the Release Status portlet from above with an explanation as to what some of the icons are for:

Previously Asked Questions

* What's happiness? (or... The secret to happiness)

Obviously you're all wondering what makes happiness. How does one tell the health of a project. What secret bit of wizardry and hours of cpu-intensive magic is this portlet doing???

Fortunately, here at CBA Industries we decided to take the simple approach to happiness. It's simply: "If the project continues to maintain the velocity of the last 7 days, will it hit its release date?". Nothing fancy, nothing special and something to be taken with a LOT of salt. Amongst its limitations it includes non-work days as if they were normal days and it treats all issues the same regardless of estimate.

* How do I see the open issues?

Most of the items in the release portlet are clickable. To see the current open issues, click on the green part of the progress bar. To see the closed issues, click on the red part. To see all the issues in a version, click on the version name.

* How do I configure a list of versions?

Versions are added via a comma-separated list of ids on the portlet configuration page. Version ids can be found by mousing over a version link pretty much anywhere in JIRA (it will be called fixFor or version in the URL). You will see the link in the status bar at the bottom of your browser (you may need to turn on the Status bar).