Skip to content

Conversation

@coltondotio
Copy link
Contributor

Fixes FER-

Short description of the changes made

This PR reverts the revert from PR #5706, restoring the original loader refactor (9b185fce6) and MDX parallelization (fdd07184c) commits while preserving the FDR fallback fixes from #5709 and #5710.

Key changes restored:

  • Loader refactor (readonly-docs-loader.ts): Re-adds DocsBranch* types, loadDocsBranch function, and loadDocsResponse cached wrapper. Updates fallback paths to use loadDocsResponse instead of direct loadWithUrl calls.
  • MDX parallelization (LayoutEvaluator.tsx, ChangelogPage.tsx): Restores parallel serialization of title, subtitle, and main content using Promise.all.
  • PageHeader (PageHeader.tsx): Re-adds titleMdx and subtitleMdx props for pre-serialized MDX content.
  • SerializedMdx export (mdx-serializer.ts): Exports the SerializedMdx type separately.
  • Revalidate route: Updates getMetadataFromResponse calls to pass { baseUrl } instead of full response.

What was the motivation & context behind this PR?

The revert in #5706 didn't fix the underlying issue. This PR undoes that revert while ensuring the FDR fallback fixes (getFilesUncached and related changes from #5709/#5710) remain in place.

How has this PR been tested?

  • Lint checks pass (pnpm lint:biome)
  • Format applied (pnpm format)
  • Verified getFilesUncached function is still present and exposed in CachedDocsLoader

Human review checklist

  • Verify getFilesUncached is still properly exposed and the "retry with uncached files" logic in serialize.ts works with the restored parallelization
  • Confirm getMetadataFromResponse signature change (accepting { baseUrl } instead of full response) is correct at all call sites in revalidate/route.ts
  • Test that MDX parallelization doesn't cause race conditions with the FDR fallback retry mechanism

Link to Devin run: https://app.devin.ai/sessions/ce4e90665acb43a48c37f968833d72cc
Requested by: Sandeep Dinesh (@sandeepdinesh)

@devin-ai-integration
Copy link
Contributor

🤖 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

@vercel
Copy link
Contributor

vercel bot commented Dec 6, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Updated (UTC)
dev.ferndocs.com Ready Ready Preview Dec 6, 2025 5:11pm
fern-dashboard Ready Ready Preview Dec 6, 2025 5:11pm
fern-dashboard-dev Ready Ready Preview Dec 6, 2025 5:11pm
prod-assets.ferndocs.com Ready Ready Preview Dec 6, 2025 5:11pm
prod.ferndocs.com Ready Ready Preview Dec 6, 2025 5:11pm
1 Skipped Deployment
Project Deployment Preview Updated (UTC)
fern-platform Ignored Ignored Dec 6, 2025 5:11pm

@github-actions
Copy link
Contributor

github-actions bot commented Dec 6, 2025

🌱 Smoke Test Preview

Testing branch changes with smoke test content:

🕷️ Smoke Test Crawler Results

Pages crawled: 35
Successful: 35 ✅
With errors: 0

🎉 All pages loaded successfully with no errors!

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