docs(other): add blog post on AI features shipped in May-July and the AI roadmap - #351
Conversation
2880ee8 to
ceafac3
Compare
![redocly[bot]](https://avatars.githubusercontent.com/in/348054?s=60&v=4){kind=small}
There was a problem hiding this comment.
marketing-site AI Review: 🟢 Completed
Redocly Agent has reviewed your changes and found 5 potential issue(s).
Note
Low Risk
This PR introduces new blog content and author metadata without affecting application logic, operational systems, or deployment configurations.
Overview
Adds a new blog post covering customer-facing AI features shipped between May and July 2026 (including Docs MCP updates, llms.txt improvements, agent discovery, and the Reunite AI Assistant) alongside the upcoming AI roadmap (Gateway MCP, custom tools, and more). Additionally, registers Illia Nykonchuk as a blog author in blog-metadata.yaml and includes their profile image.
| MCP is one door into your docs; [`llms.txt`](https://redocly.com/docs/realm/config/seo) is the other, and we made what's behind both doors better: | ||
|
|
||
| - `llms.txt` output now includes **OpenAPI code samples and response samples**, and correctly renders `oneOf` and discriminator schemas: exactly the parts of an API description agents used to trip over. | ||
| - Custom Markdoc tags can define their **own LLM rendering** with `renderForLlms`, with locale support. If you built a custom component, its content is no longer invisible to AI. |
There was a problem hiding this comment.
Token refresh, MCP/A2A cards, agent skills, and renderForLlms locale support are only in 0.136.0-next. Rephrase so they don't sound already live, or ensure publication is strictly delayed until the stable release.
| MCP is one door into your docs; [`llms.txt`](https://redocly.com/docs/realm/config/seo) is the other, and we made what's behind both doors better: | ||
|
|
||
| - `llms.txt` output now includes **OpenAPI code samples and response samples**, and correctly renders `oneOf` and discriminator schemas: exactly the parts of an API description agents used to trip over. | ||
| - Custom Markdoc tags can define their **own LLM rendering** with `renderForLlms`, with locale support. If you built a custom component, its content is no longer invisible to AI. |
There was a problem hiding this comment.
The blog claims renderForLlms has locale support, but customization/build-markdoc-tags.md does not document locale or translate in its context table (only getBody is documented). Update the docs or adjust the claim.
2 participants
What/Why/How?
Blog post covering the customer-facing AI features shipped in May-July (Docs MCP, llms.txt, agent discovery, AI Assistant in Reunite) plus the roadmap (Gateway MCP, code mode, custom MCP tools, Maintainer, embeddable AI Assistant).
Also adds Illia Nykonchuk as a blog author (metadata entry + photo).
Do not merge before the next stable Realm release: token refresh, MCP server card / A2A agent card, agent skills, and
renderForLlmslocale support are currently in0.136.0-nextonly.Reference
Testing
Check yourself
Security