diff --git a/.changeset/chatty-crabs-tap.md b/.changeset/chatty-crabs-tap.md
index 88871f817a..97ec05fb61 100644
--- a/.changeset/chatty-crabs-tap.md
+++ b/.changeset/chatty-crabs-tap.md
@@ -2,4 +2,17 @@
 '@backstage/repo-tools': minor
 ---
 
-Adds a lint rule to `repo schema openapi lint` to enforce `allowReserved: true`.
+Adds a lint rule to `repo schema openapi lint` to enforce `allowReserved` for all parameters. To fix this, simply add `allowReserved: true` to your parameters, like so
+
+```diff
+/v1/todos:
+    get:
+      operationId: ListTodos
+      # ...
+      parameters:
+        - name: entity
+          in: query
++         allowReserved: true
+          schema:
+            type: string
+```