Add: Use AI to write custom OpenAPI lint rules

[riboflavin]

Summary

• Adds learn/ai-for-docs/ai-write-custom-openapi-lint-rules.md from the Calendar draft.
• Updates learn/ai-for-docs/sidebars.yaml with the new page entry.

Test plan

• Preview the page locally via npm start
• Confirm sidebar label and SEO front matter
• Spot-check internal links and How Redocly can help

[redocly]

marketing-site AI Review: 🟢 Completed

Redocly Agent has reviewed your changes and found 1 potential issue(s).

Note

Low Risk

This PR strictly contains documentation changes, adding a new article and its corresponding sidebar entry. There are no runtime code or behavior changes, meaning there is zero operational risk.

Overview

Adds a new guide, ai-write-custom-openapi-lint-rules.md, detailing how to use AI to draft custom OpenAPI lint rules for Redocly CLI. The article covers generating both YAML-based configurable rules and JavaScript-based custom rule plugins, providing examples, prompt templates, and best practices for testing new rules before enforcing them. Additionally, it updates learn/ai-for-docs/sidebars.yaml to include the new page in the navigation structure.

[redocly]

The contains assertion silently passes if the required property is missing entirely. Add defined: true to the main assertions block to fix this false negative. Also, consider adding a MediaType subject to where to avoid falsely flagging header schemas.