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

GitHub Action

AzDO release notes for GitHub

v1.0.0

AzDO release notes for GitHub

clipboard

AzDO release notes for GitHub

Enhanced AB#xxx links in GitHub release notes for Azure DevOps work items

Installation

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

              

- name: AzDO release notes for GitHub

uses: karpikpl/[email protected]

Learn more about this action in karpikpl/azdo-release-notes-action

Choose a version

Azure DevOps GitHub release notes integration

GitHub Super-Linter CI Check dist/ CodeQL Coverage

Enhanced AB#xxx links in GitHub release notes for Azure DevOps work items. Every AB#x reference in the release notes is replaced with a link.

Before:

- AB#11 Feature/adding ci by @karpikpl in
  https://github.com/repoOwner/repoName/pull/1

After:

- [AB#11 [User Story] Best Feature so far (Completed)](https://dev.azure.com/adoOrg/adoProject/_workitems/edit/11)
  Feature/adding ci by @karpikpl in https://github.com/repoOwner/repoName/pull/1

Usage

Basic

You need to add permissions for this tool.

permissions:
  contents: write

Here's an example pipeline that updates release notes after publishing.

name: Update Release Notes

on:
  release:
    types: [published]
  workflow_dispatch:
    inputs:
      releaseId:
        description:
          'The Id of the release to update - database Id (integer), not visible
          in the UI'
        required: true
        type: number

permissions:
  contents: write

jobs:
  update-release-notes:
    runs-on: ubuntu-latest

    steps:
      - name: Install dependencies
        run: npm install node-fetch

      - name: Update release notes
        uses: karpikpl/[email protected]
        with:
          ado-pat: ${{ secrets.ADO_PAT }}
          ado-org: my-org
          ado-project: my-project

Inputs

ado-pat

Required Azure DevOps personal access token with permissions to read work items.

ado-org

Required Name of the Azure DevOps organization.

ado-project

Required Name of the Azure DevOps project.

repo-owner

Optional Another repository owner, If not set, the current repository owner is used by default. Note that when you trying changing a repository, be aware that GITHUB_TOKEN should also have permission for that repository.

repo-name

Optional Another repository name. Of limited use on GitHub enterprise. If not set, the current repository is used by default. Note that when you trying changing a repository, be aware that GITHUB_TOKEN should also have permission for that repository.

repo-token

Optional, You can set PAT here. If not set, this will use ${{ github.token }}.

Outputs

workItems

Coma separated list of work items that were processed.