Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

semantic-release-jira-notes

iamludal35kMIT4.0.0

Semantic Release plugin to add JIRA issues link to the release notes

jira, semantic-release, release-notes, changelog

readme

semantic-release-jira-notes

ESM-only package NPM version Node version Dependencies status Install size

semantic-release plugin to add links to JIRA issues in the release notes.

For each JIRA issue detected in the release notes, it will add a link that brings directly to this issue on JIRA.

Step Description
verifyConditions Validate the config options
generateNotes Generate the release notes with links to JIRA issues

Preview

Preview

Usage

Installation

# npm
npm install --save-dev semantic-release-jira-notes
# yarn
yarn add --dev semantic-release-jira-notes
# pnpm
pnpm add --save-dev semantic-release-jira-notes

Inputs

Name Required Description
jiraHost Your JIRA host domain name
ticketPrefixes Ticket prefixes to match. If not provided, match all tickets prefixes.

Configuration

{
  "plugins": [
    "@semantic-release/commit-analyzer",
    ["semantic-release-jira-notes", {
      "jiraHost": "iamludal.atlassian.net",
      "ticketPrefixes": ["ATP", "OMS"]
    }]
    "@semantic-release/git",
    "@semantic-release/github"
  ]
}

Note: this plugin uses @semantic-release/release-notes-generator under the hood, so you don't need to use it anymore.

You can also use options defined by @semantic-release/release-notes-generator.

{
  "plugins": [
    "@semantic-release/commit-analyzer",
    ["semantic-release-jira-notes", {
      "jiraHost": "iamludal.atlassian.net",
      "preset": "conventionalcommits",
      "presetConfig": {
        "types": [
          { "type": "feat", "section": "Features" },
          { "type": "fix", "section": "Bug Fixes" },
          { "type": "build", "section": "Dependencies Updates", "hidden": false }
        ]
      }
    }]
    "@semantic-release/git",
    "@semantic-release/github"
  ]
}

changelog

4.0.0 (2024-05-28)

Code Refactoring

BREAKING CHANGES

  • migrate imports from CommonJS to ESM

3.0.0 (2022-07-01)

Bug Fixes

  • generate-notes: use release-notes-generator plugin (e7c0770)

BREAKING CHANGES

  • generate-notes: users should now remove release-notes-generator from their plugin list.

2.0.1 (2022-06-30)

Bug Fixes

  • generate-notes: get notes from context (d988d34)

2.0.0 (2022-06-28)

Features

  • generate-notes: don't use release-notes-generator manually (cd8cbe1)

BREAKING CHANGES

  • generate-notes: release-notes-generator should now be defined in the configuration file before semantic-release-jira-notes

1.0.3 (2022-06-28)

Bug Fixes

  • verify: error when ticketPrefixes is undefined (283ff8f)