Skip to content

Render mermaid diagrams in the registry products' docs - #2017

Merged
Urigo merged 2 commits into
masterfrom
fix/registry-mermaid
Sep 20, 2026
Merged

Urigo merged 2 commits into
masterfrom
fix/registry-mermaid

Conversation

@Urigo

@Urigo Urigo commented Sep 20, 2026

Copy link
Copy Markdown
Member

Summary

Arda pointed out on ardatan/schema-stitching#1870 that the architecture diagram on the Stitching docs index renders as a plain code block. The content is a normal ```mermaid fence; the cause is on this side: the mermaid rehype plugin was scoped to Hive, Yoga and Mesh files only. The ten registry products now get it alongside their shared code-block setup.

Test plan

  • Full build: the Stitching docs index now emits one rendered mermaid SVG and no leftover flowchart TD code block; the inline client icon inside the diagram survives. Hive's own diagrams still render.
  • Screenshots of the diagram in light and dark mode.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added Mermaid diagram support to product documentation pages.
    • Product cards can now display an additional title alongside the product name.
    • Expanded the GraphQL ecosystem page with new platform, server, tooling, and developer experience products.
  • Content Updates

    • Reorganized ecosystem offerings into clearer categories.
    • Updated product descriptions, links, icons, page metadata, and introductory copy.

Urigo and others added 2 commits September 18, 2026 21:26
…copy

The page still carried Nextra, three-letter codes instead of the product
marks, big cards with no description, and a "Security" section holding one
card. It also had no place for the eight registry libraries.

Now four sections: Federation Platform (Hive, Hive Router, Hive Gateway,
Stellate), Servers & Subgraphs (Yoga, Mesh, Envelop, Modules, Stitching,
SOFA, GraphQL over WebSocket, GraphQL over SSE), Schema Tooling (Inspector,
Tools, Scalars, Config) and Developer Experience (Codegen, ESLint, Apollo
Angular). Small cards use the real marks, big cards carry a one-line
description, and the copy mentions the Grafbase and Stellate acquisitions.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The mermaid rehype plugin was scoped to Hive, Yoga and Mesh content only, so
the Schema Stitching docs index showed its architecture diagram as a plain
code block. The registry products now get the same plugin as their shared
code-block setup.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Sep 20, 2026

Copy link
Copy Markdown

Review Change StackReview Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 22ca48f5-e257-44fc-a53e-d92e629f461c

📥 Commits

Reviewing files that changed from the base of the PR and between 3e93fd9 and c7dcc22.

📒 Files selected for processing (3)
  • website/astro.config.mjs
  • website/src/hive/components/ecosystem/ProductCard.astro
  • website/src/pages/graphql/hive/ecosystem.astro

Included review availability: Your plan provides up to 2 included reviews per hour; 1 remains after this review.


📝 Walkthrough

Walkthrough

The PR reorganizes the Hive ecosystem page, extends product card title rendering, and enables Mermaid processing for registry product MDX files.

Changes

Hive ecosystem presentation

Layer / File(s) Summary
Ecosystem content and product catalog
website/src/pages/graphql/hive/ecosystem.astro
The page now uses four product sections, updated product entries and imports, revised metadata, and new hero copy.
Product card title rendering
website/src/hive/components/ecosystem/ProductCard.astro
The main card variant wraps the product name and conditionally renders a styled title.
Registry product Mermaid processing
website/astro.config.mjs
Registry product MDX files now receive the Mermaid rehype plugin in addition to code-block processing.

Priority: ➖ Normal

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Bug fix

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the main change: enabling Mermaid diagram rendering in registry product documentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 1…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

Copy link
Copy Markdown

💻 Website Preview

The latest changes are available as preview in: https://pr-2017.guild-dev-website.pages.dev

@Urigo
Urigo merged commit 3c2ed6f into master Sep 20, 2026
7 checks passed
@Urigo
Urigo deleted the fix/registry-mermaid branch September 20, 2026 03:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant