Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
alert-circle

GitHub Action

Enforce Pull Request Title includes Jira Issue Key

v1

Enforce Pull Request Title includes Jira Issue Key

alert-circle

Enforce Pull Request Title includes Jira Issue Key

Check that a PR title starts with a Jira Issue Key

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Enforce Pull Request Title includes Jira Issue Key

uses: ryanvade/enforce-pr-title-style-action@v1

Learn more about this action in ryanvade/enforce-pr-title-style-action

Choose a version

Enforce Pull Request Title Style Action

This action analyses the titles of Pull Requests to ensure they start with a Jira Issue Key. Issue Keys are a combination of a Project Key, a hyphen, and a number designating which issue it is. In general, Project Keys are two capital letters but Jira does allow for custom Project Keys and this issue attempts to abide by the custom format.

For example, if your project key were AB then the following would be allowed

AB-1  Initialize Project

However, the following examples would not be allowed

aB-1 Initialize Project
ab-1 Initialize Project
Ab 1 Initialize Project

Valid Pull Request titles must also include a short description after the Issue Key. Therefore the following is not valid.

AB-1

By default, this action will allow any valid Issue Key so long as it could be valid. If you want to be specific to your project, use the projectKey input for the action.

Inputs

projectKey

A specific Project Key to always check for.

Example Usage

- name: Enforce Jira Issue Key in Pull Request Title
  uses: ryanvade/enforce-pr-title-style-action@v1

Example Usage with a specific Project Key

- name: Enforce Jira Issue Key in Pull Request Title
  uses: ryanvade/enforce-pr-title-style-action@v1
  with:
    projectKey: AB