Skip to content

Flatten Relay API reference navigation #451

Closed
fern-api[bot] wants to merge 1 commit into
devon/relay-asyncapi-toolingfrom
fern/pr423-flat-sections
Closed

Flatten Relay API reference navigation #451
fern-api[bot] wants to merge 1 commit into
devon/relay-asyncapi-toolingfrom
fern/pr423-flat-sections

Conversation

@fern-api

@fern-api fern-api Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Fixes the extra nested sections in the Relay API reference (from PR #423). Every Relay channel was getting its own nested subpackage folder in the sidebar because x-fern-sdk-group-name carried a trailing per-channel element.

The fix trims the group path arity so the tree renders flat, keeping only the deliberate section grouping for calling:

  • Non-calling services (signalwire, messaging, provisioning, tasking/queuing, webrtc): group name reduced to a single element, e.g. [signalwire, connect][signalwire]. Channels now render flat directly under their section.
  • Calling: group name reduced from three elements to two, e.g. [calling, setup, dial][calling, setup]. Channels render flat inside the one manually-set section (Call Setup & Lifecycle, Playback, etc.) instead of each getting its own nested folder.

Source of truth is TypeSpec; fern/apis/relay/relay.yaml was regenerated from the updated .tsp group constants (net: 140 group-array lines removed, no other spec changes).

URL impact

Endpoint URLs lose the per-channel folder segment (e.g. /relay/signalwire/connect/signalwire-connect/relay/signalwire/signalwire-connect). These pages are new in the unmerged PR, so no redirects are needed.

Requested by: Fern Support

@fern-api

fern-api Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor Author

Requested by: Devon White
Slack thread: View conversation

@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

@Devon-White Devon-White closed this Jul 7, 2026
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