diff --git a/ci/playbooks/create_lightspeed_secret.yml b/ci/playbooks/create_lightspeed_secret.yml
index 2146049..a84173d 100644
--- a/ci/playbooks/create_lightspeed_secret.yml
+++ b/ci/playbooks/create_lightspeed_secret.yml
@@ -46,7 +46,8 @@
 # `run`. An in-cluster Secret is the only hand-off that survives: a job var is
 # out of scope at serialization, set_fact doesn't cross the pre-run boundary,
 # and a params file gets published by log collection. Uses `oc` because
-# ci-framework's `kubernetes` lib is absent on `crc`.
+# the Python `kubernetes` library required by Ansible's `kubernetes.core.k8s`
+# module (used by CI-Framework) is absent on the CRC node.
 - name: Pre-create the OpenStack Lightspeed API token Secret
   hosts: crc
   gather_facts: false
diff --git a/zuul.d/jobs.yaml b/zuul.d/jobs.yaml
index 4de0c5f..251e792 100644
--- a/zuul.d/jobs.yaml
+++ b/zuul.d/jobs.yaml
@@ -13,7 +13,6 @@
     secrets:
       - name: openai_credentials
         secret: lightspeed-openai-token
-    # Creates the token Secret in-cluster before the run (see playbook header).
     pre-run: ci/playbooks/create_lightspeed_secret.yml
     # cleanup: true so Zuul still attempts the delete when the job is canceled.
     post-run: