diff --git a/.github/workflows/push.yml b/.github/workflows/push.yml
index 3edb19590..bb1374053 100644
--- a/.github/workflows/push.yml
+++ b/.github/workflows/push.yml
@@ -124,6 +124,8 @@ jobs:
       # By default the ajv-cli runs in strict mode which will fail if the schema
       # itself is not valid. Strict mode is more strict than the JSON schema
       # specification. See for details: https://ajv.js.org/options.html#strict-mode-options
+      # The ajv-cli is configured to use the markdownDescription keyword which is not part of the JSON schema specification,
+      # but is used in editors like VSCode to render markdown in the description field
       - name: Validate bundle schema
         run: |
           go run main.go bundle schema > schema.json