This documentation is intended for developers integrating with JIRA who want to start getting ready for JIRA 5.1.
Please watch the JIRA EAP releases for pre-release versions of JIRA 5.1 that you can use for testing purposes.
JIRA 5.1 is the first major release of JIRA following the introduction of our stable Java API and stable REST API. Any plugins developed on top of the stable APIs in 5.0 should be binary compatible with JIRA 5.1.
Please read through the information below to see if any of this content is relevant to your plugin.
If you are using a plugin developed by a third party, please check with the plugin's author to see if the plugin has been tested with JIRA 5.1.
Nevertheless, if your plugin exposes any content on JIRA's 'view issue' page, please take note of the information on Working with Inline Edit in JIRA 5.1 to ensure that your plugin maintains compatibility with the inline edit features introduced in JIRA 5.1.
Jira has been upgraded to the 1.6 version of Velocity Engine. This has allowed us to provide an automatic html escaping facility through the velocity-html-safe library used by both Confluence and the Atlassian Template Renderer.
No changes to your existing templates are required for JIRA 5.1. If you would like to start using the feature for new templates you only need to include the velocity directive in your template and all velocity references will be automatically escaped unless:
Detailed documentation on this feature and a migration strategy can be found in the JIRA HTML escaping for velocity templates documentation.
In JIRA 5.0 and earlier indexing of issues was stopped during the processing of an issue transition. This meant that if a workflow post function created an issue or amended an issue other than the issue being transitioned, those changes were not correctly indexed. There were documented workarounds for this behaviour that entailed re-enabling indexing in the function and disabling it again.
From JIRA 5.1 on this behaviour is changed. Indexing is now suspended during the workflow transition, with all indexing requests being queue up and processed at the end of the transition. Plugin developers should no longer enable and disable indexing in workflow post functions.