From e19d0c2f38a0e481cb56acdee1c084bf5614b62e Mon Sep 17 00:00:00 2001
From: musjj <72612857+musjj@users.noreply.github.com>
Date: Sun, 27 Apr 2025 18:30:45 +0700
Subject: [PATCH] nixos/i18n: document the change in the release notes

---
 doc/release-notes/rl-2505.section.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/release-notes/rl-2505.section.md b/doc/release-notes/rl-2505.section.md
index 639a89d883b5..a257ca8cdffe 100644
--- a/doc/release-notes/rl-2505.section.md
+++ b/doc/release-notes/rl-2505.section.md
@@ -344,6 +344,11 @@
 
 ## Other Notable Changes {#sec-nixpkgs-release-25.05-notable-changes}
 
+- `i18n` module improvements:
+  - `i18n.extraLocales` should now be the preferred way to install additional locales.
+  - `i18n.supportedLocales` is now considered an implementation detail and will be hidden from the documentation. But the option will still continue to work.
+  - `i18n.supportedLocales` will now trigger a warning when it omits any locale set in `i18n.defaultLocale`, `i18n.extraLocales` or `i18n.extraLocaleSettings`.
+
 - `titaniumenv`, `titanium`, and `titanium-alloy` have been removed due to lack of maintenance in Nixpkgs []{#sec-nixpkgs-release-25.05-incompatibilities-titanium-removed}.
 
 - androidenv has been improved: