From 79f458c86b720e6a1dc73b267960e3ab8ab26a45 Mon Sep 17 00:00:00 2001
From: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com>
Date: Fri, 24 Oct 2025 11:17:34 +0100
Subject: [PATCH] update comment

---
 redocly.yaml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/redocly.yaml b/redocly.yaml
index 31dcfa41..294d2f10 100644
--- a/redocly.yaml
+++ b/redocly.yaml
@@ -9,5 +9,6 @@ rules:
   no-path-trailing-slash: off
   operation-2xx-response: off
   spec-strict-refs: error
-  # $ref in examples are not spec-compliant so we perform this check in a python script.
+  # $ref in examples are not spec-compliant, yet we find them useful. Disable this rule
+  # and instead check example schema using `check-event-schema-examples.py`
   no-invalid-schema-examples: off