diff --git a/.github/workflows/README.md b/.github/workflows/README.md new file mode 100644 index 00000000..c9c3f5dc --- /dev/null +++ b/.github/workflows/README.md @@ -0,0 +1,11 @@ +# Workflows + +There are two types of workflows in this directory. I would put them in subfolders but GitHub doesn't support that. + +## Callers + +These are the high level workflows that can be associated with what triggers them. PRs, releases, nightlys, merges, etc. These are made up of jobs that are defined the the other workflows. These are the workflows that you will see in the Actions tab of the repo. By grouping these tasks into parent workflows, the jobs are grouped under one action in the actions tab. They share the smaller 'job' workflows so that they always run the same way. + +## Jobs + +These are the smaller individual tasks that are used to build up the larger parent workflows. They can be thought of as running unit tests, building the binaries, or linting the code. When you open one of the parent caller actions in the actions tab, they will show these individual jobs.