diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index c6992c9..ea6eedb 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -22,6 +22,8 @@ jobs:
   collect:
     name: Collect images from directories
     runs-on: ubuntu-latest
+    # Map step outputs to job outputs, so that the data can be used in upcoming jobs
+    # https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idoutputs
     outputs:
       IMAGES: ${{ steps.images.outputs.directories }}
 
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index f11cdf6..45d45f2 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -15,6 +15,8 @@ jobs:
   collect:
     name: Collect images from directories
     runs-on: ubuntu-latest
+    # Map step outputs to job outputs, so that the data can be used in upcoming jobs
+    # https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idoutputs
     outputs:
       IMAGES: ${{ steps.images.outputs.directories }}
 
diff --git a/source/images.yml b/source/images.yml
index 0289664..4aa25ae 100644
--- a/source/images.yml
+++ b/source/images.yml
@@ -1,3 +1,5 @@
+# Images configuration
+
 images:
   - name: "base"
     tags: ["base"]