Document possible getLocale returns values. Closes #5363

docs/api/app.md

@@ -396,7 +396,7 @@ Overrides the current application's name.
 
 ### `app.getLocale()`
 
-Returns the current application locale.
+Returns the current application locale. Possible return values are documented [here](../faq/app-locale.md)
 
 **Note:** When distributing your packaged app, you have to also ship the
 `locales` folder.

docs/faq/app-locale.md

@@ -0,0 +1,138 @@
+Possible Values of `app.getLocale()`
+------------------------------------
+
+Electron uses Chromium's l10n util library to fetch the locale.  Possible values are listed below  
+
+
+| Language Code | Language Name |
+|---------------|---------------|
+| af | Afrikaans |
+| ar-AE | Arabic (U.A.E.) |
+| ar-IQ | Arabic (Iraq) |
+| ar | Arabic (Standard) |
+| ar-BH | Arabic (Bahrain) |
+| ar-DZ | Arabic (Algeria) |
+| ar-EG | Arabic (Egypt) |
+| ar | Aragonese |
+| ar-JO | Arabic (Jordan) |
+| ar-KW | Arabic (Kuwait) |
+| ar-LB | Arabic (Lebanon) |
+| ar-LY | Arabic (Libya) |
+| ar-MA | Arabic (Morocco) |
+| ar-OM | Arabic (Oman) |
+| ar-QA | Arabic (Qatar) |
+| ar-SA | Arabic (Saudi Arabia) |
+| ar-SY | Arabic (Syria) |
+| ar-TN | Arabic (Tunisia) |
+| ar-YE | Arabic (Yemen) |
+| as | Assamese |
+| ast | Asturian |
+| az | Azerbaijani |
+| be | Belarusian |
+| bg | Bulgarian |
+| bg | Bulgarian |
+| bn | Bengali |
+| br | Breton |
+| bs | Bosnian |
+| ca | Catalan |
+| ce | Chechen |
+| ch | Chamorro |
+| co | Corsican |
+| cr | Cree |
+| cs | Czech |
+| cv | Chuvash |
+| da | Danish |
+| de | German (Standard) |
+| de-AT | German (Austria) |
+| de-CH | German (Switzerland) |
+| de-DE | German (Germany) |
+| de-LI | German (Liechtenstein) |
+| de-LU | German (Luxembourg) |
+| el | Greek |
+| en-AU | English (Australia) |
+| en-BZ | English (Belize) |
+| en | English |
+| en-CA | English (Canada) |
+| en-GB | English (United Kingdom) |
+| en-IE | English (Ireland) |
+| en-JM | English (Jamaica) |
+| en-NZ | English (New Zealand) |
+| en-PH | English (Philippines) |
+| en-TT | English (Trinidad & Tobago) |
+| en-US | English (United States) |
+| en-ZA | English (South Africa) |
+| en-ZW | English (Zimbabwe) |
+| eo | Esperanto |
+| et | Estonian |
+| eu | Basque |
+| fa | Persian |
+| fa | Farsi |
+| fa-IR | Persian/Iran |
+| fi | Finnish |
+| fj | Fijian |
+| fo | Faeroese |
+| fr-CH | French (Switzerland) |
+| fr-FR | French (France) |
+| fr-LU | French (Luxembourg) |
+| fr-MC | French (Monaco) |
+| fr | French (Standard) |
+| fr-BE | French (Belgium) |
+| fr-CA | French (Canada) |
+| fur | Friulian |
+| fy | Frisian |
+| ga | Irish |
+| gd-IE | Gaelic (Irish) |
+| gd | Gaelic (Scots) |
+| gl | Galacian |
+| gu | Gujurati |
+| he | Hebrew |
+| hi | Hindi |
+| hr | Croatian |
+| ht | Haitian |
+| hu | Hungarian |
+| hy | Armenian |
+| id | Indonesian |
+| is | Icelandic |
+| it-CH | Italian (Switzerland) |
+| it | Italian (Standard) |
+| iu | Inuktitut |
+| ja | Japanese |
+| ka | Georgian |
+| kk | Kazakh |
+| km | Khmer |
+| kn | Kannada |
+| ko | Korean |
+| ko-KP | Korean (North Korea) |
+| ko-KR | Korean (South Korea) |
+| ks | Kashmiri |
+| ky | Kirghiz |
+| la | Latin |
+| lb | Luxembourgish |
+| lt | Lithuanian |
+| lv | Latvian |
+| mi | Maori |
+| mk | FYRO Macedonian |
+| ml | Malayalam |
+| mo | Moldavian |
+| mr | Marathi |
+| ms | Malay |
+| mt | Maltese |
+| my | Burmese |
+| nb | Norwegian (Bokmal) |
+| ne | Nepali |
+| ng | Ndonga |
+| nl | Dutch (Standard) |
+| nl-BE | Dutch (Belgian) |
+| nn | Norwegian (Nynorsk) |
+| no | Norwegian |
+| nv | Navajo |
+| oc | Occitan |
+| om | Oromo |
+| or | Oriya |
+| sq | Albanian |
+| tlh | Klingon |
+| zh-TW | Chinese (Taiwan) |
+| zh | Chinese |
+| zh-CN | Chinese (PRC) |
+| zh-HK | Chinese (Hong Kong) |
+| zh-SG | Chinese (Singapore) |