Skip to content

Commit bfcd251

Browse files
committed
docs: Proofread blog post
1 parent 5a7f7be commit bfcd251

File tree

1 file changed

+22
-22
lines changed

1 file changed

+22
-22
lines changed

docs/src/pages/blog/next-intl-4-0.mdx

+22-22
Original file line numberDiff line numberDiff line change
@@ -11,28 +11,18 @@ import StayUpdated from '@/components/StayUpdated.mdx';
1111

1212
(this post is still a draft)
1313

14-
After a year of feature development, this release mostly aims to clean up the API surface to ensure `next-intl` remains lean—there should be no big surprises. Many significant improvements have already been shipped in [minor versions](/blog/next-intl-3-22) previously.
15-
16-
However, this release also comes with a series of improvements that you might find useful.
14+
After a year of feature development, this release mostly aims to clean up the API surface to ensure `next-intl` remains lean—there should be no big surprises. Many significant improvements have already been shipped in [minor versions](/blog/next-intl-3-22) previously. However, this release also comes with a series of improvements that you might find useful.
1715

1816
Here's what's new in `next-intl@4.0`:
1917

20-
1. [**Modernized build output**](#modernized-build-output)
21-
2. [**Revamped augmented types**](#revamped-augmented-types)
22-
3. [**Strictly-typed locale**](#strictly-typed-locale)
23-
4. [**Strictly-typed ICU arguments**](#strictly-typed-icu-arguments)
24-
5. [**GDPR compliance**](#gdpr-compliance)
18+
1. [**Revamped augmented types**](#revamped-augmented-types)
19+
2. [**Strictly-typed locale**](#strictly-typed-locale)
20+
3. [**Strictly-typed ICU arguments**](#strictly-typed-icu-arguments)
21+
4. [**GDPR compliance**](#gdpr-compliance)
22+
5. [**Modernized build output**](#modernized-build-output)
2523
6. [**Preparation for upcoming Next.js features**](#nextjs-future)
2624

27-
## Modernized build output
28-
29-
The build output of `next-intl` has been modernized and now leverages the following optimizations:
30-
31-
1. **ESM-only:** To enable enhanced tree-shaking and align with the modern JavaScript ecosystem, `next-intl` is now ESM-only. The only exception is `next-intl/plugin` which is published both as CommonJS as well as ESM, due to `next.config.js` still being popular.
32-
2. **Modern JSX transform:** The peer dependency for React has been bumped to v17 in order to use the more efficient, modern JSX transform.
33-
3. **Modern syntax:** Syntax is now compiled down to the Browserslist `defaults` query, which is a shortcut for `>0.5%, last 2 versions, Firefox ESR, not dead`—a baseline that is considered a reasonable target for modern apps.
34-
35-
With these changes, the bundle size of `next-intl` has been reduced by ~7% ([all details](https://github.com/amannn/next-intl/pull/1470)).
25+
Please also have a look at the [other breaking changes](#other-breaking-changes) before you [upgrade](#upgrade-now).
3626

3727
## Revamped augmented types
3828

@@ -112,7 +102,7 @@ Note that strictly-typing the `Locale` is optional and can be used as desired in
112102

113103
How type-safe can your app be?
114104

115-
The quest to bring type safety to the last corner of `next-intl` has led me down a rabbit hole with the discovery of an ICU parser by [Marco Schumacher](https://github.com/schummar)—written entirely in types. Marco kindly published his implementation for usage in `next-intl` with me only adding support for rich tags on top.
105+
The quest to bring type safety to the last corner of `next-intl` has led me down a rabbit hole with the discovery of an ICU parser by [Marco Schumacher](https://github.com/schummar)—written entirely in types. Marco kindly published his implementation for usage in `next-intl`, with me only adding support for rich tags on top.
116106

117107
Check it out:
118108

@@ -180,7 +170,17 @@ As part of this change, disabling a cookie now requires you to set [`localeCooki
180170

181171
Learn more in the [locale cookie](/docs/routing#locale-cookie) docs.
182172

183-
## Preparation for upcoming Next.js features
173+
## Modernized build output
174+
175+
The build output of `next-intl` has been modernized and now leverages the following optimizations:
176+
177+
1. **ESM-only:** To enable enhanced tree-shaking and align with the modern JavaScript ecosystem, `next-intl` is now ESM-only. The only exception is `next-intl/plugin` which is published both as CommonJS as well as ESM, due to `next.config.js` still being popular.
178+
2. **Modern JSX transform:** The peer dependency for React has been bumped to v17 in order to use the more efficient, modern JSX transform.
179+
3. **Modern syntax:** Syntax is now compiled down to the Browserslist `defaults` query, which is a shortcut for `>0.5%, last 2 versions, Firefox ESR, not dead`—a baseline that is considered a reasonable target for modern apps.
180+
181+
With these changes, the bundle size of `next-intl` has been reduced by ~7% ([all details](https://github.com/amannn/next-intl/pull/1470)).
182+
183+
## Preparation for upcoming Next.js features [#nextjs-future]
184184

185185
To ensure that the sails of `next-intl` are set for a steady course in the upcoming future, I've investigated the implications of upcoming Next.js features like [Partial Prerendering](https://nextjs.org/docs/app/api-reference/next-config-js/ppr) and [`dynamicIO`](https://nextjs.org/docs/canary/app/api-reference/config/next-config-js/dynamicIO) for `next-intl`.
186186

@@ -203,7 +203,7 @@ async function Component() {
203203
}
204204
```
205205

206-
If things go well, I think this will finally fill in the [missing piece](https://github.com/vercel/next.js/discussions/58862) that enables apps with i18n routing to support static rendering without workarounds like `setRequestLocale`.
206+
If things go well, I think this will finally fill in the [missing piece](https://github.com/vercel/next.js/discussions/58862) that enables apps with i18n routing to support static rendering without workarounds like `setRequestLocale`. I hope to have more to share on this soon!
207207

208208
## Other breaking changes
209209

@@ -219,15 +219,15 @@ If things go well, I think this will finally fill in the [missing piece](https:/
219219

220220
For a smooth upgrade, please initially upgrade to the latest v3.x version and check for deprecation warnings.
221221

222-
Once all warnings are resolved, you can upgrade by running:
222+
Afterwards, you can upgrade by running:
223223

224224
```
225225
npm install next-intl@v4
226226
```
227227

228228
## Thank you
229229

230-
I want to sincerely thank everyone who has helped to make `next-intl` what it is today. A special thank you goes to <PartnerContentLink href="https://crowdin.com/">Crowdin</PartnerContentLink>, the primary sponsor of `next-intl`, enabling me to regularly dedicate time for this project.
230+
I want to sincerely thank everyone who has helped to make `next-intl` what it is today. A special thank you goes to <PartnerContentLink href="https://crowdin.com/">Crowdin</PartnerContentLink>, the primary sponsor of `next-intl`, enabling me to regularly work on this project.
231231

232232
—Jan
233233

0 commit comments

Comments
 (0)