diff --git a/custom-plugin-decorators/openai-is-consequential/README.md b/custom-plugin-decorators/openai-is-consequential/README.md
index 5b27ef1..e66b690 100644
--- a/custom-plugin-decorators/openai-is-consequential/README.md
+++ b/custom-plugin-decorators/openai-is-consequential/README.md
@@ -20,13 +20,15 @@ The code is entirely in `openai-is-consequential.js`:
 
 ```javascript
 export default function plugin() {
-  id: "openai-plugin",
-  decorators: {
-    oas3: {
-      "is-consequential": OpenAIConsequential,
+  return {
+    id: "openai-plugin",
+    decorators: {
+      oas3: {
+        "is-consequential": OpenAIConsequential,
+      },
     },
-  },
-};
+  };
+}
 
 /** @type {import('@redocly/cli').OasDecorator} */
 function OpenAIConsequential() {
diff --git a/custom-plugin-decorators/openai-is-consequential/openai-is-consequential.js b/custom-plugin-decorators/openai-is-consequential/openai-is-consequential.js
index 758af4a..4daa1d6 100644
--- a/custom-plugin-decorators/openai-is-consequential/openai-is-consequential.js
+++ b/custom-plugin-decorators/openai-is-consequential/openai-is-consequential.js
@@ -1,9 +1,10 @@
 export default function plugin() {
-  id: "openai-plugin",
-  decorators: {
-    oas3: {
-      "is-consequential": OpenAIConsequential,
-    },
+  return {
+    id: "openai-plugin",
+    decorators: {
+      oas3: {
+        "is-consequential": OpenAIConsequential,
+      },
   },
 };
 
diff --git a/rulesets/spec-compliant/README.md b/rulesets/spec-compliant/README.md
index 726ca51..85c61a7 100644
--- a/rulesets/spec-compliant/README.md
+++ b/rulesets/spec-compliant/README.md
@@ -43,7 +43,7 @@ rules:
 Here is why each rule is included:
 
 - `struct`: [ensures structural correctness](https://redocly.com/docs/cli/rules/spec/#api-design-principles)
-- `nullable-type-sibling`: [ensures compliance with the OpenAPI 3.0 spec](https://redocly.com/docs/cli/v2/rules/oas/nullable-type-sibling)
+- `nullable-type-sibling`: [ensures compliance with the OpenAPI 3.0 spec](https://redocly.com/docs/cli/rules/oas/nullable-type-sibling)
 - `spec-strict-refs`: ["strict adherence to the specifications"](https://redocly.com/docs/cli/rules/spec-strict-refs/#api-design-principles)
 - `no-undefined-server-variable`: ["it's an error with the specification"](https://redocly.com/docs/cli/rules/no-undefined-server-variable/#api-design-principles)
 - `path-declaration-must-exist`: ["This rule is for spec correctness"](https://redocly.com/docs/cli/rules/path-declaration-must-exist/#api-design-principles)