Github

Issue labels

We use a Github Action to add a default set of issue labels to a repository. These default labels are partly based on the Flow Framework, and partly on standard Github labels.

We use the Issue Label Manager Action for this. The example action triggers on each issues event, which seems a bit too frequent. Instead, we trigger on a label event: whenever a change is made to the labels, the defaults are added.

A typical approach would be:

Create the repository on Github
Add the Github Action configuration (see the files below) and push
Go to the issue labels, and remove an unneccessary label.
The action should trigger, and the default labels should appear.

File .github/workflows/add-default-labels.yml

on: label
name: Create Default Labels
jobs:
  labels:
    name: DefaultLabelsActions
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: lannonbr/issue-label-manager-action@3.0.0
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          delete: false

File .github/labels.json

[
  {
    "name": "Debt",
    "color": "ff9a00",
    "description": "Removal of impedements to future development (architecture changes, refactoring, infrastructure)"
  },
  {
    "name": "Defect",
    "color": "ff453c",
    "description": "Fixes for quality that affect the customer experience (bugs, incidents, changes)"
  },
  {
    "name": "Feature",
    "color": "25c33c",
    "description": "New business value visible to the customer (requirement, user story)"
  },
  {
    "name": "Risk",
    "color": "f2d600",
    "description": "Security, governance, compliance (vulnerability, regulatory requirement)"
  },
  {
    "name": "Epic",
    "color": "3E4B9E",
    "description": ""
  },
  {
    "name": "duplicate",
    "color": "cccccc",
    "description": "This issue or pull request already exists"
  },
  {
    "name": "idea",
    "color": "d4c5f9",
    "description": "Discovery of potential features or improvements"
  },
  {
    "name": "wontfix",
    "color": "ffffff",
    "description": "This will not be worked on"
  },
  {
    "name": "documentation",
    "color": "0075ca",
    "description": "Improvements or additions to documentation"
  }
]