From 9168ca3d6041593b19a12d973870478be32cd373 Mon Sep 17 00:00:00 2001
From: ST-DDT <ST-DDT@gmx.de>
Date: Sun, 23 Jan 2022 13:06:29 +0100
Subject: [PATCH] docs: update locale list/table in docs

---
 README.md                |  2 +-
 docs/api/localization.md | 97 ++++++++++++++++++++++++----------------
 2 files changed, 59 insertions(+), 40 deletions(-)

diff --git a/README.md b/README.md
index 8e7b89b900a..b6196d97aa2 100644
--- a/README.md
+++ b/README.md
@@ -430,7 +430,7 @@ Setting a new locale is simple:
 faker.locale = 'de';
 ```
 
-**List of locales:** az, ar, cz, de, de_AT, de_CH, en, en_AU, en_AU_ocker, en_BORK, en_CA, en_GB, en_IE, en_IND, en_US, en_ZA, es, es_MX, fa, fi, fr, fr_CA, fr_CH, ge, hy, hr, id_ID, it, ja, ko, nb_NO, ne, nl, nl_BE, pl, pt_BR, pt_PT, ro, ru, sk, sv, tr, uk, vi, zh_CN, zh_TW
+See our documentation for a list of [provided languages](https://fakerjs.dev/api/localization.html#localization)
 
 ### Individual Localization Packages
 
diff --git a/docs/api/localization.md b/docs/api/localization.md
index 39ab6ccdad3..6152d32f876 100644
--- a/docs/api/localization.md
+++ b/docs/api/localization.md
@@ -13,45 +13,64 @@ faker.setLocale('de');
 faker.locale = 'de';
 ```
 
-- az
-- cz
-- de
-- de_AT
-- de_CH
-- en
-- en_AU
-- en_BORK
-- en_CA
-- en_GB
-- en_IE
-- en_IND
-- en_US
-- en_ZA
-- en_au_ocker
-- es
-- es_MX
-- fa
-- fr
-- fr_CA
-- ge
-- id_ID
-- it
-- ja
-- ko
-- nb_NO
-- nep
-- nl
-- pl
-- pt_BR
-- pt_PT
-- ru
-- sk
-- sv
-- tr
-- uk
-- vi
-- zh_CN
-- zh_TW
+| Locale      | Name                      |
+| :---------- | :------------------------ |
+| af_ZA       | Afrikaans                 |
+| ar          | Arabic                    |
+| az          | Azerbaijani               |
+| cz          | Czech                     |
+| de          | German                    |
+| de_AT       | German (Austria)          |
+| de_CH       | German (Switzerland)      |
+| el          | Greek                     |
+| en          | English                   |
+| en_AU       | English (Australia)       |
+| en_AU_ocker | English (Australia Ocker) |
+| en_BORK     | English (Bork)            |
+| en_CA       | English (Canada)          |
+| en_GB       | English (Great Britain)   |
+| en_GH       | English (Ghana)           |
+| en_IE       | English (Ireland)         |
+| en_IND      | English (India)           |
+| en_NG       | Nigeria (English)         |
+| en_US       | English (United States)   |
+| en_ZA       | English (South Africa)    |
+| es          | Spanish                   |
+| es_MX       | Spanish (Mexico)          |
+| fa          | Farsi                     |
+| fi          | Finnish                   |
+| fr          | French                    |
+| fr_BE       | Français (Belgique)       |
+| fr_CA       | French (Canada)           |
+| fr_CH       | French (Switzerland)      |
+| ge          | Georgian                  |
+| he          | Hebrew                    |
+| hr          | Hrvatski                  |
+| hy          | Armenian                  |
+| id_ID       | Indonesia                 |
+| it          | Italian                   |
+| ja          | Japanese                  |
+| ko          | Korean                    |
+| lv          | Latvian                   |
+| mk          | Macedonian                |
+| nb_NO       | Norwegian                 |
+| ne          | Nepalese                  |
+| nl          | Dutch                     |
+| nl_BE       | Dutch (Belgium)           |
+| pl          | Polish                    |
+| pt_BR       | Portuguese (Brazil)       |
+| pt_PT       | Portuguese (Portugal)     |
+| ro          | Romanian                  |
+| ru          | Russian                   |
+| sk          | Slovakian                 |
+| sv          | Swedish                   |
+| tr          | Turkish                   |
+| uk          | Ukrainian                 |
+| ur          | Urdu                      |
+| vi          | Vietnamese                |
+| zh_CN       | Chinese                   |
+| zh_TW       | Chinese (Taiwan)          |
+| zu_ZA       | Zulu (South Africa)       |
 
 ## Individual Localization Packages