[samuv]

Summary

• Group each RPC, request, and response in one cell so service tables are easier to scan.
• Render service rows as labeled cards on screens up to 640 px wide, with streaming flags side by side and the description below.
• Fit the desktop service table to the content width with proportional columns and wrapping for long RPC types.
• Collapse RPC descriptions only when they exceed three rendered lines, recalculating on resize. Read more expands the text; Read less stays below it.
• Hide the table of contents on the schema reference page.
• Regenerate the schema reference from the current protobufs and updated template.

Reader need and owner

Readers looking up gRPC method signatures and descriptions use user-docs/reference/grpc-schema.md. The source for the service tables is scripts/grpc-schema.md.tmpl.

Verification

• task docs:grpc-ref regenerated the page from the template.
• task site:build passed.
• At 390 px and 320 px, a browser check found no document overflow. It also confirmed the mobile labels, empty-description collapse, and Read less placement. At desktop width, rows retain their table layout.
• At 1024, 1280, 1440, and 1920 px, the desktop service table has no horizontal overflow.

[peppescg]

Approving: none of the points below are blocking.

The source change is in scripts/grpc-schema.md.tmpl, and the page was regenerated from it rather than edited by hand. Descriptions still pass through table-safe, which HTML-escapes them, so no markup can reach the MDX JSX. The toggle's ARIA wiring is correct (aria-controls, aria-expanded, and a per-RPC label). The page also degrades well without JavaScript: the full text stays visible.

Optional follow-ups

1. Descriptions are duplicated in the DOM. GrpcDescription renders each description twice: once in the hidden measure span and once in the visible span. Browser find-in-page skips visibility:hidden text, but @easyops-cn/docusaurus-search-local indexes the built HTML. It probably indexes all ~70 descriptions twice, which would give doubled search hits (not verified on a built site). Measuring the visible span directly, with the clamp temporarily removed, would avoid the second copy.
2. Layout shifts on hydration. overflows starts false, so the static HTML shows full descriptions and they collapse after mount. On a page of about 4.3k lines, the content shifts visibly on load. This is an acceptable trade-off for no-JS readability; just noting it.
3. Table semantics on mobile. At 640 px and below, display: block/grid on table, tr and td drops the table roles in several browsers. The grpc-mobile-label spans mostly compensate. Explicit role="table"/role="row" attributes are optional.
4. Generated-file conflicts. #1891 and #1909 also touch grpc-schema.md. Whichever PR lands later only needs to run task docs:grpc-ref again.