This is a template with some basic workflows and files that can be used by new and existing repos. There is a related project template that is connected to this repo.
- Create a new repository with the "Use this template" button
- Create a new GitHub project in the org
- Generate a Personal Access Token with
repo
andproject
permissions. Use the "Classic" tokens because the new tokens don't support organization-scoped permissions at the time of writing this. - Add a secret to the repository named
ADD_TO_PROJECT_PAT
with the token you created in the previous step. - Open the
add-issue-to-project.yml
file and replace theproject-url
value with the URL of the project created in step 2. - Change the content of the issue templates according to the project needs. New projects might work well enough with blank issues; in that case, just delete that directory.
The repo contains two automation workflows:
add-issue-to-project.yml
adds every new issue and pull request to the configured projectadd-label-to-new-issue.yml
adds thestatus:triaging
label to all new issues and pull requests, unless they already have a label that starts withstatus:
. This means that issues created by external users will get this label, but without affecting issues opened by repo owners that set a status during creation.
The related GitHub project relies on certain labels being used in the issue tracker. This repo comes with a basic set of labels for that purpose, but each project can add new ones according to its needs.