HfLA GitHub Actions

Workflows are yaml files

Supporting files can be

• js
• json
• md
• gitkeep

Hack for LA's GHAs

• ✔️ Workflow: add-update-label-weekly.yml
  • Supporting Files Folder: add-update-label-weekly
    • File: https://github.com/hackforla/website/blob/gh-pages/github-actions/add-update-label-weekly/add-label.js references
      • https://github.com/hackforla/website/blob/gh-pages/github-actions/add-update-label-weekly/update-instructions-template.md (same folder)
      • https://github.com/hackforla/website/blob/gh-pages/github-actions/utils/find-linked-issue.js (utils folder)

Scheduled to run at 7:00 every Friday	Checks the in-progress column from the project board. Goes through each issue, and if there is an assignee, checks the timeline for the issue. If it is outdated, posts a comment to update the issue and ensures the label is changed to 'to update.' Else, change the label so it is 'updated'

• ✔️ Workflow: github-data.yml
  • Supporting Files Folder 1: github-data
  • Data: https://github.com/hackforla/website/blob/gh-pages/_data/external/github-data.json

Scheduled to run everyday at 11:00	Generates a new github-data.json and commits that to the repository

• ✔️ Workflow: issue-trigger.yml
  • Supporting Files Folder: trigger-issue/add-missing-labels-to-issues
  • Support File obtain-labels.js located in utils folder (Check if obtain-labels.js file is still being used in this workflow)

Issue opened	Check if an issue has the three required labels. If not, add the 'missing' labels and post a comment about adding missing labels. If the issue has all, post a comment that congratulates and gives more details about the project board

• ✔️ Workflow: lint-scss.yml
  • Data: https://github.com/hackforla/website/blob/gh-pages/.stylelintrc.json

PR opened, on push	Checks and lints modified scss files in PRs

• ✔️ Workflow: move-closed-issues.yaml
  • Supporting Files Folder: move-closed-issues

Issue closed

Moves a closed issue into either the QA or Done column of the project board. If the issue has a “hard” label (Feature: Refactor CSS, Feature: Refactor HTML, Feature: Refactor JS / Liquid, Feature: Refactor GH), the issue is moved to the Done column. If the issue has no “hard” labels but does have an “override” label (role: front end), the issue is moved to the QA column. If the issue has no “hard” or “override” labels and does have a “soft” label (role: back end/devOps, Feature: Analytics), it is moved to Done. All other issues are moved to QA.

• ✔️ Workflow: pr-instructions.yml
  • Supporting Files Folder: pr-instructions

PR opened	Creates an instruction on how to get a copy of a PR branch for review, then uploads the results into an artifact

• ✔️ Workflow: pull-request-trigger.yml

Pull request closed	An open script that could be triggered when a pull request is closed on the following branches 'gh-pages', 'feature-homepage-launch', 'feature-tech-dropdown'

• ✔️ Workflow: set-pr-labels.yaml
  • Supporting Files Folder: https://github.com/hackforla/website/tree/gh-pages/github-actions/trigger-pr

PR opened, PR edited	RegEx takes the issue number on the body of the PR, and uploads the results (including labels on the issue) into an artifact

• ✔️ Workflow: update-team-members.yml
  • Supporting Files Folder: https://github.com/hackforla/website/tree/gh-pages/github-actions/github-data

Scheduled to run at 11:00 every Thursday	Trim inactive members from the write team

• ✔️ Workflow: vrms-data.yml
  • Data: https://github.com/hackforla/website/blob/gh-pages/_data/external/vrms_data.json

Scheduled to run everyday at 10:00	Generates a new vrms_data.json and commits that to the repository

• ✔️ Workflow: wr-pr-instructions.yml
  • Supporting Files Folder: https://github.com/hackforla/website/tree/gh-pages/github-actions/pr-instructions

Workflow [Add Pull Request Instructions] completed	Leaves a comment on new PRs with a link to the relevant documentation for reviewing PRs and the command line instructions for pulling down a new branch for review.

• ✔️ Workflow: wr-pull-request-trigger.yml

Pull request closed	An open script that should house all the other scripts (workflows) that should be triggered when a pull request is closed

• ✔️ Workflow: wr-set-pr-labels.yaml
  • Supporting Files Folder: trigger-pr

Workflow [Set PR Labels] completed	This workflow is triggered when workflow [Set PR labels] is completed. Downloads artifact for the completed workflow. Then, gets the PR and issue number from the downloaded artifact and uses an API request to get the labels. Lastly, puts the same labels into the PR.

---

extra folders or files with unknown workflows

• Supporting Files Folder: trigger-schedule - folder has one file .gitkeep and its empty - The .gitkeep was likely added as a way of forcing git to track the new empty directory when the person who created the GHA began working on it. This is not a supported feature of git and now that there is content in the directory, there is no real need for the .gitkeep file The commit message for the .gitkeep file is just “Create directory for gha refactor”