nextjs - ✅(Solved) Fix Docs: internationalization app router [2 pull requests, 3 comments, 3 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
vercel/next.js#89668Fetched 2026-04-08 02:02:29
View on GitHub
Comments
3
Participants
3
Timeline
11
Reactions
0
Timeline (top)
commented ×3cross-referenced ×2closed ×1issue_type_added ×1

Fix Action

Fixed

PR fix notes

PR #89641: chore(doc): update the internationalization doc add a example of repl…

Description (problem / solution / changelog)

Update the internationalization doc, add an optional function to use for replacement

Fixes #89668

Changed files

  • docs/01-app/02-guides/internationalization.mdx (modified, +22/-0)

PR #89743: docs: clarify limitations of basic i18n example

Description (problem / solution / changelog)

This PR adds a 'Good to know' note to the Internationalization guide to clarify that the provided dictionary example is intended for basic text localization. It explicitly recommends using dedicated libraries for complex use cases like interpolation or pluralization, aligning with recent discussions in closed issues (e.g., #89668) regarding keeping the core lightweight and avoiding maintenance of custom i18n implementations in documentation.

Changed files

  • docs/01-app/02-guides/internationalization.mdx (modified, +2/-0)
  • packages/next/src/client/components/error-boundary.tsx (modified, +31/-1)
  • test/e2e/app-dir/error-retry/app/error.js (added, +23/-0)
  • test/e2e/app-dir/error-retry/app/layout.js (added, +7/-0)
  • test/e2e/app-dir/error-retry/app/page.js (added, +12/-0)
  • test/e2e/app-dir/error-retry/index.test.ts (added, +35/-0)
RAW_BUFFERClick to expand / collapse

What is the documentation issue?

In the app router documnetaion i think there are some part that are good to be mentiond likereplacinge the dynamic text or the types that can be used over the app.

Is there any context that might help us understand?

Based on when I want to implement the internationalization i stuck in some place that may a lots of people face, so I think it's good to havea more complete doc.

Does the docs page already exist? Please link to it.

https://nextjs.org/docs/app/guides/internationalization

extent analysis

TL;DR

  • The documentation for Next.js internationalization could be improved with more details on replacing dynamic text and supported types.

Guidance

  • Review the existing documentation at https://nextjs.org/docs/app/guides/internationalization to identify areas that need clarification or expansion.
  • Consider adding examples or sections on handling dynamic text replacement and supported data types for internationalization.
  • Check if there are any open issues or discussions related to internationalization documentation on the Next.js GitHub repository.
  • Look into contributing to the Next.js documentation by submitting a pull request with proposed changes or improvements.

Notes

  • The issue seems to be related to the quality and completeness of the documentation rather than a specific technical problem.
  • Improving documentation can help many users who may face similar challenges with internationalization.

Recommendation

  • Apply workaround: Contribute to the documentation by submitting a pull request with proposed changes, as this can help address the issue directly and benefit the community.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

nextjs - ✅(Solved) Fix Docs: internationalization app router [2 pull requests, 3 comments, 3 participants]