This repository contains reusable workflows for our Code Sample Validation (CSV) and Code Quality Automation (CQA) related projects.

• Workflows are defined within the .github/workflows folder.

GitHub Actions provides the capability to reuse workflows across projects for efficiency and consistency.

• Reusable workflows are the called workflows.
• Workflows that use them are the caller workflows.
  • A caller can have multiple called workflows
  • Called workflows behave as though they were inline (part of the original caller workflow)
  • The github context gets associated with the caller workflow.
  • The called workflow gets seamless access to github.token and secrets.GITHUB_TOKEN for executing jobs within caller environment.
  • The called workflow does NOT get access to env context defined at workflow level in the caller. To reuse variables, set them at {org, repo, or env} level and referene then using vars context.
• You can call a maximum of 20 reusable workflows from a caller workflow. Nested workflows count against this quota.

GitHub also has the capability to create starter workflows that serve as baseline templates for your organization.

The primary difference is that starter workflows help you create new workflows from a common base, while reusable worflows help you call an existing workflow and run it inline with your current workflow as the runtime context.

You can reference a reusable workflow in a starter workflow as a way of making starters more composable while centrally managing code.