Skip to content

Commit 4478f62

Browse files
authored
Update modules/ROOT/pages/migration-from-7x.adoc
1 parent f48930e commit 4478f62

File tree

1 file changed

+9
-5
lines changed

1 file changed

+9
-5
lines changed

modules/ROOT/pages/migration-from-7x.adoc

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -299,9 +299,9 @@ editor.dispatch('someEvent');
299299
==== Language Pack Filename Changes
300300
// #TINY-12090
301301

302-
Language pack filenames have been standardized to follow the RFC5646 format. This change ensures consistent language handling across different platforms and improves internationalization support.
302+
Language pack filenames have been standardized to follow the RFC5646 format. This update ensures consistent language handling across platforms and improves internationalization support. While both the legacy underscore format (e.g., `en_GB.js`) and the new hyphenated format (e.g., `en-GB.js`) are supported in {productname} {release-version}, the underscore format is deprecated and will be removed in {productname} 9. Migrating to the RFC5646 format now will ensure future compatibility and reduce maintenance overhead during upcoming upgrades.
303303

304-
**Impact**: Custom language packs using the old naming format will need to be updated.
304+
**Impact**: Custom language packs and configurations using the underscore-based format should update before upgrading to {productname} 9 to avoid loading failures.
305305

306306
**Migration checklist:**
307307

@@ -310,17 +310,21 @@ Language pack filenames have been standardized to follow the RFC5646 format. Thi
310310
* [ ] Update configuration references to language files
311311
* [ ] Update build scripts that handle language files
312312
* [ ] Test language switching in your application
313-
* [ ] Update custom translation files to new format
313+
* [ ] Update custom translation files to use the new format
314314

315315
[source, javascript]
316316
----
317-
// Old configuration
317+
// Deprecated format (supported only in versions 8.x)
318318
language_url: '/langs/en_GB.js'
319319
320-
// New configuration
320+
// Recommended format
321321
language_url: '/langs/en-GB.js'
322322
----
323323

324+
[IMPORTANT]
325+
Support for the underscore format will be removed in {productname} 9. Early migration is recommended.
326+
327+
324328
==== Update to Image and Accessibility Checker Plugins
325329
// #TINY-12235
326330

0 commit comments

Comments
 (0)