Skip to content

Update sidebar paths to include /docs/pre-recorded-audio/ and /docs/streaming/ prefixes#840

Merged
MAsuamah merged 2 commits intomainfrom
devin/1774557354-sidebar-path-prefixes
Mar 26, 2026
Merged

Update sidebar paths to include /docs/pre-recorded-audio/ and /docs/streaming/ prefixes#840
MAsuamah merged 2 commits intomainfrom
devin/1774557354-sidebar-path-prefixes

Conversation

@devin-ai-integration
Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration bot commented Mar 26, 2026

Summary

Updates the Fern docs sidebar configuration so that pages in the Pre-recorded STT tab resolve under /docs/pre-recorded-audio/ and pages in the Streaming STT tab resolve under /docs/streaming/.

Navigation changes:

  • async-stt tab: changed from skip-slug: trueslug: pre-recorded-audio
  • streaming-stt tab: changed from skip-slug: trueslug: streaming
  • Both tabs' Models sections changed from explicit slugs (pre-recorded-audio / /streaming) to skip-slug: true, since the tab slug now provides the prefix
  • Pages that previously had absolute slugs containing the prefix (e.g. /pre-recorded-audio/select-the-speech-model, /streaming/concurrency) were converted to relative slugs (e.g. /select-the-speech-model, /concurrency) so the tab-level slug provides the prefix without doubling
  • Several absolute slugs in the Streaming Models section were also converted to relative slugs (/turn-detectionturn-detection, /whisper-streamingwhisper-streaming, /medical-modemedical-mode, /message-sequencemessage-sequence)
  • Two slug renames beyond prefix changes:
    • Evaluations (pre-recorded): /evaluations/pre-recorded-audio/evaluations (resolves to /docs/pre-recorded-audio/evaluations)
    • Streaming endpoints: /streaming-endpoints-and-data-zones/endpoints-and-data-zones (resolves to /docs/streaming/endpoints-and-data-zones)
  • Hidden overview page slug changed from /pre-recorded-audiooverview (resolves to /docs/pre-recorded-audio/overview)
  • Legacy pre-recorded audio overview page: explicit slug removed (inherits from file path)

Redirect changes:

  • ~50 existing redirect destinations updated to point to new URLs
  • ~100 new redirects added for old URLs → new URLs (features, guides, migration guides, getting-started pages)
  • 3 redirects at the bottom of the file that previously pointed FROM /docs/pre-recorded-audio/{page} TO /docs/{page} were reversed (for supported-languages, language-detection, code-switching)
  • Removed the catch-all redirect source: /docs/streaming → destination: /docs/streaming/select-the-speech-model

Review & Testing Checklist for Human

  • Verify no redirect loops exist. Several redirects were reversed (e.g. supported-languages, language-detection, code-switching). Check that no source URL matches another redirect's destination in a way that creates a cycle.
  • Deploy a preview and spot-check that relative slugs resolve correctly. All page slugs now rely on the tab-level slug for the prefix. Confirm URLs like /docs/pre-recorded-audio/webhooks, /docs/streaming/concurrency, /docs/pre-recorded-audio/keyterms-prompting actually render (not 404 or doubled).
  • Verify the Models section URLs are unchanged. The strategy changed from section slug: pre-recorded-audio / section slug: /streaming to tab slug + section skip-slug: true. Net URLs for pages like /docs/pre-recorded-audio/universal-3-pro and /docs/streaming/universal-3-pro should remain the same.
  • Check the two slug renames resolve correctly and have proper redirects. Evaluations: old /docs/evaluations/pre-recorded-audio should redirect to /docs/pre-recorded-audio/evaluations. Streaming endpoints: old /docs/streaming-endpoints-and-data-zones should redirect to /docs/streaming/endpoints-and-data-zones.
  • Test high-traffic redirect paths end-to-end. Particularly: /docs/webhooks, /docs/getting-started/transcribe-an-audio-file, /docs/getting-started/transcribe-streaming-audio, /docs/language-detection, /docs/supported-languages.

Recommended test plan: Deploy a preview build and:

  1. Navigate directly to old URLs (e.g. /docs/webhooks, /docs/guides/subtitles, /docs/streaming-endpoints-and-data-zones) and confirm they redirect to the correct new location
  2. Navigate the Pre-recorded STT and Streaming STT sidebars and verify all links work
  3. Confirm URLs in the browser include the expected /pre-recorded-audio/ or /streaming/ prefix
  4. Verify that /docs/streaming resolves as the tab landing page (no 404)

Notes

  • Pages in other tabs (Overview, API Reference, Voice Agents, Speech Understanding, Guardrails, LLM Gateway, FAQ) are not affected by this change.
  • Hidden/legacy pages also had their slugs updated to maintain consistency.
  • Some redirect destinations that referenced pages outside these two tabs (e.g. /docs/account-management, /docs/guardrails/*) were intentionally left unchanged.
  • Fern prepends tab slugs to all child page slugs (including those starting with /), which is why page slugs were converted to relative form rather than keeping absolute paths with the prefix.

Link to Devin session: https://app.devin.ai/sessions/5ed562868e764248b53fd2fd2462de9d
Requested by: @LeeVaughn

…treaming/ prefixes

- Change async-stt tab from skip-slug to slug: pre-recorded-audio
- Change streaming-stt tab from skip-slug to slug: streaming
- Update page slugs within both tabs to maintain correct URLs
- Add redirects for all changed page URLs
- Update existing redirect destinations to match new URLs

Co-Authored-By: Lee Vaughn <dlvprogramming@gmail.com>
@devin-ai-integration
Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@github-actions
Copy link
Copy Markdown

…slug prefixing

Co-Authored-By: Lee Vaughn <dlvprogramming@gmail.com>
@github-actions
Copy link
Copy Markdown

@MAsuamah MAsuamah merged commit ecda66f into main Mar 26, 2026
4 checks passed
@MAsuamah MAsuamah deleted the devin/1774557354-sidebar-path-prefixes branch March 26, 2026 21:23
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.

2 participants