chore: remove orphaned .mdx files not referenced in docs.yml#762
chore: remove orphaned .mdx files not referenced in docs.yml#762
Conversation
Remove .mdx files that exist on disk but are not referenced anywhere in docs.yml (neither in navigation nor as Markdown src imports): - audio-intelligence/auto-chapters-response.mdx - audio-intelligence/summarization-response.mdx - guides/index.mdx - universal-streaming/multichannel-streaming.mdx - universal-streaming/streaming-diarization.mdx - universal-streaming/universal-streaming.mdx - universal-streaming/voice-agents/index.mdx - universal-streaming/voice-agents/livekit.mdx - universal-streaming/voice-agents/pipecat.mdx - universal-streaming/voice-agents/vapi.mdx Note: 8 other response .mdx files (e.g. entity-detection-response.mdx) were initially identified as orphaned but are actually used via <Markdown src> imports inside active docs pages, so they are retained. Co-Authored-By: michelle <michey.asmah21@gmail.com>
🤖 Devin AI EngineerI'll be helping with this pull request! Here's what you should know: ✅ I will automatically:
Note: I can only respond to comments from users who have write access to this repository. ⚙️ Control Options:
|
|
@lee I compared the PR preview against the live docs. Here are the results: All 165 visible pages return HTTP 200 on both the live site and the preview site. No pages are missing from the preview. I also checked whether the deleted files' potential URLs were accessible on the live site. 7 URLs returned 200 on both live and preview — meaning those URLs are served by other pages in
Summary: No visible docs pages are lost in this PR. The 10 deleted |
2 participants
Summary
Removes 10
.mdxfiles fromfern/pages/that are not referenced anywhere indocs.ymland are not used as<Markdown src="..."/>imports in any other active page. These files were identified during a docs audit.Deleted files:
audio-intelligence/auto-chapters-response.mdx— example JSON response snippet, unusedaudio-intelligence/summarization-response.mdx— example JSON response snippet, unusedguides/index.mdx— large (1223 lines) "Cookbooks" overview page with custom CSS, no longer in navigationspeech-to-text/universal-streaming/multichannel-streaming.mdxspeech-to-text/universal-streaming/streaming-diarization.mdxspeech-to-text/universal-streaming/universal-streaming.mdxspeech-to-text/universal-streaming/voice-agents/index.mdxspeech-to-text/universal-streaming/voice-agents/livekit.mdxspeech-to-text/universal-streaming/voice-agents/pipecat.mdxspeech-to-text/universal-streaming/voice-agents/vapi.mdxNot deleted (initially flagged but actually in use): 8
*-response.mdxfiles (e.g.entity-detection-response.mdx,pii-redaction-response.mdx) that are embedded in active pages via<Markdown src="..."/>imports.Fern lint passes with 0 errors after this change.
Review & Testing Checklist for Human
guides/index.mdxis safe to remove — this is the largest deletion (1223 lines with custom CSS/cards). Confirm this "Cookbooks" overview page has been replaced or is no longer needed. Note:guides/styles/styles.cssstill has a comment referencing it.voice-agents/vapi.mdx,voice-agents/livekit.mdx, andvoice-agents/pipecat.mdxpages may have been linked from external partner docs or blog posts. Verify these URLs redirect or are handled.auto-chapters-response.mdxandsummarization-response.mdxare truly unused — unlike the other 7 response files (which are<Markdown src>imports), these two had no references found. Worth a quick confirmation.Recommended test plan: Deploy a docs preview and verify no broken pages or missing content appear in the Speech-to-Text, Audio Intelligence, and Guides sections.
Notes