diff --git a/.github/workflows/__test-proxy.yml b/.github/workflows/__test-proxy.yml
index b6e1a0814..d2ffe1f6b 100644
--- a/.github/workflows/__test-proxy.yml
+++ b/.github/workflows/__test-proxy.yml
@@ -38,6 +38,9 @@ jobs:
     timeout-minutes: 45
     runs-on: ${{ matrix.os }}
     steps:
+  # These steps are required to initialise the `gh` cli in a container that doesn't
+  # come pre-installed with it. The reason for that is that this is later
+  # needed by the `prepare-test` workflow to find the latest release of CodeQL.
       - name: Set up GitHub CLI
         run: |
           apt update
diff --git a/pr-checks/checks/test-proxy.yml b/pr-checks/checks/test-proxy.yml
index 9560ec4bc..39efb214e 100644
--- a/pr-checks/checks/test-proxy.yml
+++ b/pr-checks/checks/test-proxy.yml
@@ -5,6 +5,9 @@ operatingSystems: ["ubuntu"]
 container:
   image: ubuntu:22.04
 container-init-steps:
+  # These steps are required to initialise the `gh` cli in a container that doesn't
+  # come pre-installed with it. The reason for that is that this is later
+  # needed by the `prepare-test` workflow to find the latest release of CodeQL. 
   name: Set up GitHub CLI
   run: |
     apt update