Improve locale documentation

JulianGlueck · web-flow · commit 8d7fc1c9a0c6 · 2025-08-22T11:05:31.000+02:00
diff --git a/resources/views/docs/desktop/1/the-basics/application.md b/resources/views/docs/desktop/1/the-basics/application.md
@@ -76,14 +76,20 @@ The facade offers several methods for accessing some of the system's localisatio
 This data can be helpful for localising your application, e.g. if you want to suggest the corresponding language to the user on first launch.
 
 ```php
-App::getLocale();
-App::getLocaleCountryCode();
-App::getSystemLocale();
+App::getLocale(); // e.g. "de", "fr-FR"
+App::getLocaleCountryCode(); // e.g. "US", "DE"
+App::getSystemLocale(); // e.g. "it-IT", "de-DE"
 ```
 
-The `getLocale` method will return the full locale string used by the app. This includes both the language and the country or region.
-`getLocaleCountryCode` returns only the country code part of the locale.
+The `getLocale` method will return the locale used by the app.
+Dependening on the user's settings, this might include both the language and the country / region or the language only.
+It is based on Chromiums `l10n_util` library; see [this page](https://source.chromium.org/chromium/chromium/src/+/main:ui/base/l10n/l10n_util.cc) to see possible values.
+
+`getLocaleCountryCode` returns the user's system country code (using the [ISO 3166 code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+This information is pulled from native OS APIs. If it is not possible to detect this information, an empty string will be returned.
+
 With `getSystemLocale` you can access the system-wide locale setting. This is the locale set at the operating system level, not necessarily what the app is using.
+Under Windows and Linux, Chromium's `i18n` library is used to evaluate this information. macOS will use `[NSLocale currentLocale]`.
 
 
 ### App Badge Count
