Skip to content

chore: remove broken-links scaffold (no source fixes needed)#5408

Closed
github-actions[bot] wants to merge 2 commits intomainfrom
devin/fix-broken-links
Closed

chore: remove broken-links scaffold (no source fixes needed)#5408
github-actions[bot] wants to merge 2 commits intomainfrom
devin/fix-broken-links

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

@github-actions github-actions Bot commented May 6, 2026

Summary

The scheduled link checker flagged three URLs:

  1. [404] https://buildwithfern.com/products/sdks/custom-code.mdx
  2. [500] https://buildwithfern.com/learn/zh/docs/customization/search (×2)

After investigation, no source files need changes. Details:

[404] /products/sdks/custom-code.mdx

This stale link is being served from a cached render of https://buildwithfern.com/learn/zh/sdks/deep-dives/readme. The source file (fern/translations/zh/products/sdks/deep-dives/configure-readme.mdx) was already corrected by PR #5348 (merged 2026-05-05) to point to /learn/sdks/overview/custom-code.

The English equivalent page (/learn/sdks/deep-dives/readme) has been re-rendered with the fix and now contains zero references to the broken URL. The Chinese page is still serving a stale Vercel-cached HTML response (x-vercel-cache: HIT, etag w4nviu6o0ou3vl, cache-control: public, max-age=0, must-revalidate) that pre-dates the fix. Repeated fresh requests continue to return the cached version, so the cache is not auto-revalidating for the zh locale of this page.

This is a deployment / CDN cache invalidation issue, not a content issue. There is nothing for me to fix in source. Manual cache purge for the affected zh route, or a fresh Publish Docs run, should clear it. I confirmed via grep that there are no other source references to /products/sdks/custom-code.mdx anywhere in the repo (besides the scaffold itself).

[500] /learn/zh/docs/customization/search (×2)

Transient 5xx. The page now returns HTTP 200. Per the workflow instructions, 5xx-only signals should not result in source changes.

Changes

Only deleting the broken-links scaffold file (.github/broken-links/broken-links.md) per step 9 of the workflow instructions.

Review & Testing Checklist for Human

  • Decide whether the stale Chinese page warrants a manual Vercel cache purge / forced redeploy of /learn/zh/sdks/deep-dives/readme so the next link-checker run doesn't re-flag it.
  • Confirm you're comfortable with this PR being a no-op other than scaffold deletion.

Notes

  • Verified the live English page (/learn/sdks/deep-dives/readme) renders the fixed /learn/sdks/overview/custom-code link.
  • Verified /learn/zh/docs/customization/search now returns 200.
  • No fern docs dev preview run was needed since no MDX/YAML files changed.

Link to Devin session: https://app.devin.ai/sessions/6d851c610e384f198dd372ea0e07ee18

@devin-ai-integration devin-ai-integration Bot changed the title Fix broken links (Devin) chore: remove broken-links scaffold (no source fixes needed) May 6, 2026
@devin-ai-integration devin-ai-integration Bot marked this pull request as ready for review May 6, 2026 11:02
@devin-ai-integration
Copy link
Copy Markdown
Contributor

Findings

[404] https://buildwithfern.com/products/sdks/custom-code.mdx

The source file (fern/translations/zh/products/sdks/deep-dives/configure-readme.mdx) was already corrected by #5348 (merged 2026-05-05) to point to /learn/sdks/overview/custom-code. grep confirms no other source references exist anywhere in the repo.

The live page at /learn/zh/sdks/deep-dives/readme is still serving a stale Vercel-cached HTML response (x-vercel-cache: HIT, etag w4nviu6o0ou3vl, cache-control: public, max-age=0, must-revalidate) that pre-dates the fix. Repeated fresh requests keep returning the cached version, so it is not auto-revalidating for this zh route. The English equivalent (/learn/sdks/deep-dives/readme) has been re-rendered with the correct link.

This is a CDN cache / Vercel revalidation issue, not a content issue. Suggested next step: manually purge the cache for the zh/sdks/deep-dives/readme route, or trigger a fresh Publish Docs run on main, so the next scheduled link-check run doesn't re-flag this.

[500] /learn/zh/docs/customization/search (×2)

Transient. The page now returns HTTP 200 — per the workflow instructions, 5xx-only signals shouldn't trigger source changes.

Diff

Only deleting .github/broken-links/broken-links.md per step 9 of the workflow instructions. No .mdx/.yml changes — fern docs dev preview not needed.

@github-actions
Copy link
Copy Markdown
Contributor Author

github-actions Bot commented May 6, 2026

@davidkonigsberg davidkonigsberg deleted the devin/fix-broken-links branch May 6, 2026 12:37
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