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.
SolutionSolutions
There are two 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
| Info |
|---|
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.
| Note |
|---|
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 -
| Code Block |
|---|
project='AR' and issueType=story and fixVersion="[versionName]" |
| Code Block |
|---|
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 -
| Code Block |
|---|
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 -
Using Multiple Versions in ARN TemplatesGenerating release notes from multiple versions in a projectOn this page | ||||||||
|---|---|---|---|---|---|---|---|---|
|
| Iframe | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
