Adding issues from different projects to release notes

Background

Different teams plan their projects differently. Many teams want release notes to be generated across different Jira projects. It is possible to address this scenario either using cross-project templates or with proper use of JQL queries.

Solutions

There are three ways you can get issues from different Jira projects to be used in the release notes generation.

  • Creating a cross-project template with multiple version variables (Recently released, clean approach)

  • Creating different JQL sections for different projects inside of in-project template

  • Using project identifiers in the same JQL section inside of in-project template

Creating a cross-project template with multiple version variables

This is a recently released & cleanest approach to generate release notes from versions that are spread across different Jira projects.

Ability to create cross-project release notes templates is now available. This feature can be accessed via the cross-project ARN screen (available from the top Jira navigation).

Just ensure that the template you are creating is using multiple version variables in the form of [versionId1], [versionId2] or [versionName1], [versionName2]. When previewing the template, you will get the opportunity to choose projects & corresponding versions to generate desired release notes.

We are still working on bringing in cross-project rules. Until then, only way to generate cross project release notes is by previewing the template.

Creating different JQL sections for different projects

In this case you will create different JQL sections for each project.

For example, if I wanted to generate release notes to include stories from two Jira projects. Here’s what corresponding JQLs would look like -

1 project='AR' and issueType=story and fixVersion="[versionName]"
1 project='UD' and issueType=story and fixVersion="[versionName]"

Using project identifiers in the same JQL section

In this case you will tweak the JQL in the single section that you have in the template.

For example, if I wanted to generate release notes to include stories from two Jira projects. Here’s what corresponding JQL would look like -

1 project in ('AR', 'UD') and issueType=story and fixVersion="[versionName]"

Trick

JQLs above use fixVersion = “[versionName]” and not fixVersion = “[versionId]”

For the desired result in ARN, versions in both the projects should have same name. e.g. if both projects have version named V1.0 the query will work as expected but not if the version names are different such as V1.0 - android and V1.0 - iOS

Need to generate release notes from different projects that have different version names? Follow below link -