docs(blog): add client generator intro blog post - #399
Open
Marshevskyy wants to merge 4 commits into
Open
Conversation
- Add /blog/agent-friendly-sdks as a React page with inline hero diagram and a reviewer-style CTA card - Support react-frontmatter for .page.tsx blog posts in the theme plugin - Add blog-recent-posts shared data (top 4) and a shared RecentPosts component that excludes the currently open post; localize the BlogPost template to use it - Add api-descriptions:openapi and api-lifecycle:sdks blog categories Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…indenting The 0-indent lists markdownlint wants break Markdoc tag parsing in the project build, so keep the original indentation and skip the file like other markdoc-heavy pages.
Marshevskyy
marked this pull request as ready for review
August 27, 2026 09:59
![redocly[bot]](https://avatars.githubusercontent.com/in/348054?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
marketing-site AI Review: 🟢 Completed
Redocly Agent has reviewed your changes and found 2 potential issue(s).
Note
Low Risk
This PR safely introduces a new React-based blog post along with minor theme updates. It carries minimal risk as changes are isolated to the marketing site's blog layout and build infrastructure, and do not affect core application functionality.
Overview
Adds a React-based blog post (blog/agent-friendly-sdks.page.tsx) announcing the redocly generate-client feature.
To support React-based posts and custom layout components, this PR includes:
- Blog infrastructure: Updates
@theme/utils/blog-post.jsto parse frontmatter from.page.tsxfiles viareact-frontmatter, allowing them to appear in blog indices and RSS feeds. - Recent posts logic: Modifies
@theme/plugin.jsto fetch the top 4 recent posts and introduces a localizedBlogPosttemplate with a customRecentPostscomponent, ensuring the "Latest from our blog" section excludes the currently active post. - Metadata: Adds an
sdkssubcategory toblog-metadata.yamland a minor exclusion in the docs-tests CI workflow.
illiaRedoc
reviewed
Aug 27, 2026
- Use root-relative docs links in the CTA - Revert to api-specifications:openapi category (api-descriptions to be handled in a separate PR) - Dim the lead paragraph and add space below it - Highlight the steps tagline with TextGradient and add spacing - Use the theme CodeBlock with copy control for all code samples
illiaRedoc
approved these changes
Aug 27, 2026
Comment on lines
+132
to
+133
| No account, no config required. Flags or a <code>redocly.yaml</code>{' '} | ||
| <code>client</code> block, your choice. |
Contributor
There was a problem hiding this comment.
mb can be rephrased to prevent code block following code block
| <CtaActionColumn> | ||
| <CodeBlock | ||
| lang="bash" | ||
| header={{ controls: { copy: {} } }} |
Contributor
There was a problem hiding this comment.
Suggested change
| header={{ controls: { copy: {} } }} | |
| header={{ controls: { copy: {}, report: { hidden: true } } }} |
Contributor
There was a problem hiding this comment.
lets hide report button
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What/Why/How?
preview https://marketing-site--3aecf8.preview.redocly.app/blog/agent-friendly-sdks
Adds the "Open-source, agent-friendly SDKs and tooling from OpenAPI description" blog post announcing
redocly generate-client— built as a React page (blog/agent-friendly-sdks.page.tsx) instead of markdown, since the post has custom visuals: an inline SVG hero diagram, a numbered quick-start section with highlighted code, a generators table, and a reviewer-style CTA card with the eclipse glow.Supporting theme changes:
@theme/utils/blog-post.js— blog routes ending in.page.tsxload their frontmatter via Realm'sreact-frontmatterloader, so React posts appear in the blog index, category pages, and RSS feed like markdown posts.@theme/plugin.js— publishes a newblog-recent-postsshared data (top 4 posts) attached to every post route.@theme/components/Blog/RecentPosts.tsx+@theme/templates/BlogPost.tsx— the "Latest from our blog" section now excludes the currently open post (previously the newest post listed itself). The BlogPost template is localized from marketing-pages with that one behavioral change.blog/metadata/blog-metadata.yaml— new categories:api-descriptions:openapiandapi-lifecycle:sdks(existingapi-specificationsuntouched).Notes
publishedDateif publication slips./docs/cli/commands/generate-client,/docs/cli/guides/customize-client-generation) — verify they exist by publish time.imageunder a semi-transparent gradient, and recent posts follow the no-image convention.Testing
Verified with
npx @redocly/cli preview(1350 pages, no build errors): post renders with author/date/categories, appears first on /blog and in feed.xml with correct categories, recent-posts section excludes the open post on both React and markdown posts, new category pages return 200, and the layout holds at mobile widths.🤖 Generated with Claude Code