Fix broken links: /learn/ask-fern footer and /api-definitions/openapi/automation

[github-actions]

Summary

Fixes broken links (404s) detected by the scheduled link checker:

1. /learn/ask-fern — The Ask Fern product was moved under Docs at /learn/docs/ai-features/ask-fern/overview, but the footer still pointed to the old path.

   • Updated the "Ask Fern" link in FernFooter.tsx and footer-dist/output.js to /learn/docs/ai-features/ask-fern/overview
   • Added an explicit redirect for the bare /learn/ask-fern path in docs.yml (existing redirects only covered subpaths like /learn/ask-fern/:slug*)

2. /api-definitions/openapi/automation — This URL is missing the /learn prefix and uses the file name (automation) instead of the page's slug override (sync-your-open-api-specification).

   • Added a redirect from /api-definitions/openapi/automation → /learn/api-definitions/openapi/sync-your-open-api-specification

• Deleted the .github/broken-links/broken-links.md scaffold file

Updates since last revision

• Fixed MDX parsing error in java/changelog/2026-03-18.mdx — <String> inside a backtick span was being parsed as a JSX tag due to malformed backtick nesting (**Generic `onMessage(`Consumer<String>`)` handler** → **Generic `onMessage(Consumer<String>)` handler**). This was a pre-existing issue from main that broke the Preview Docs CI after merging. Note: the next auto-generated changelog update from the fern repo may reintroduce this if the source has the same issue.

Review & Testing Checklist for Human

• Verify the /api-definitions/openapi/automation redirect actually works: The docs instance is scoped to buildwithfern.com/learn — confirm that Fern's redirect system handles paths outside the /learn prefix (i.e. /api-definitions/...). If not, a different fix may be needed (e.g. a server-level redirect or a /learn/api-definitions/openapi/automation source path instead).
• Check that footer-dist/output.js doesn't need to be rebuilt via a build step rather than manually edited — if there's a build pipeline for this file, the manual edit could be overwritten on next build.
• Scroll to the footer on any page in the preview and confirm the "Ask Fern" link navigates correctly to /learn/docs/ai-features/ask-fern/overview.
• Visit /learn/ask-fern on the preview to confirm the redirect resolves correctly.

Suggested test plan: Open the preview link, scroll to the footer, and click the "Ask Fern" link. Then manually navigate to /api-definitions/openapi/automation and /learn/ask-fern to verify both redirects land on the expected pages.

Notes

• The /learn/ask-fern broken link appeared twice in the checker because the footer renders on every page. Both instances are the same root cause.
• Existing wildcard redirect /learn/ask-fern/:slug* did not catch the bare /learn/ask-fern path (no trailing slug), so an explicit redirect was added as a safety net.
• The /api-definitions/openapi/automation link origin is unknown — it was not found in any source file in the repo. It may be an external link or cached URL pointing to the site.
• The Java changelog MDX fix is a one-character-level change to backtick placement; consider fixing the upstream source in the fern repo's changelog generator to avoid reintroduction.

Link to Devin session: https://app.devin.ai/sessions/5151f683b2dd4b19b266c84cb1aa999a

[github-actions]

🌿 Preview your docs: https://fern-preview-devin/fix-broken-links.docs.buildwithfern.com/learn

[devin-ai-integration]

Verified using the preview link that the fix works:

• The "Ask Fern" link in the footer now correctly navigates to /learn/docs/ai-features/ask-fern/overview
• The Ask Fern overview page loads successfully at the new URL
• Also added a redirect for the bare /learn/ask-fern path as a safety net

Preview tested at: https://fern-preview-f31ae37a-07a7-47fb-9180-89dc5e5287c0.docs.buildwithfern.com/learn/docs/ai-features/ask-fern/overview

[devin-ai-integration]

CI is now passing after fixing the MDX parsing error in the Java changelog file (<String> was being parsed as a JSX tag). The preview link is live: https://fern-preview-devin/fix-broken-links.docs.buildwithfern.com/learn

@davidkonigsberg — ready for your review.