Creators of Redoc & a whole suite of #API design and documentation tools for API producers and consumers. With Redocly, you can make API docs your superpower 💪
Realm 0.137.0 is out 🚀
• A setup page for your MCP server
• A public MCP endpoint for mixed-access docs
• Accordion tags
• API search that reaches every field
Same release for Reef, Revel, and Redoc. Highlights 🧵
Teach your coding agent Redocly CLI. We publish two agent skills:
• redocly-cli: lint, bundle, preview docs, run Arazzo tests, check drift, generate clients
• redocly-lint-rules: describe a check in plain words, get a working rule
One command installs both 👇
Five new lint rules in Redocly CLI since late July, all on by default as warnings in the recommended ruleset:
• no-unsafe-markdown
• no-duplicated-enum-values
• no-illogical-composition-keywords
• spec-ref-siblings
• security-scopes-defined
What each one catches 🧵
New Markdoc tag: accordion.
Fold FAQs, edge cases, and long examples under a title. Group several with accordion-group, and add singleExpanded to keep one open at a time.
It renders a native <details> element, so keyboard and screen reader support is built in.
Is yes the same as true in YAML?
In YAML 1.1, yes. In YAML 1.2, it's just the text "yes".
Redocly CLI now catches this in AsyncAPI files: it checks the settings for message brokers like Amazon SQS and SNS, Google Pub/Sub, IBM MQ, and Pulsar.