From 180b595afb2f9ea9332a0304a1d6965cf4fb5cc5 Mon Sep 17 00:00:00 2001
From: Shahed Nasser <shahednasser@gmail.com>
Date: Thu, 23 Nov 2023 10:54:17 +0000
Subject: [PATCH] docs: added a new document for available languages (#5667)

- Add a new documentation page for available languages.
- Refer to the new page from other pages.
---
 www/apps/docs/content/admin/quickstart.mdx    |  2 +-
 www/apps/docs/content/user-guide.mdx          |  2 +-
 .../docs/content/user-guide/tips/languages.md | 36 +++++++++++++++++++
 .../docs/content/user-guide/users/profile.md  |  2 +-
 4 files changed, 39 insertions(+), 3 deletions(-)
 create mode 100644 www/apps/docs/content/user-guide/tips/languages.md

diff --git a/www/apps/docs/content/admin/quickstart.mdx b/www/apps/docs/content/admin/quickstart.mdx
index 84c999462b..5c2279e88a 100644
--- a/www/apps/docs/content/admin/quickstart.mdx
+++ b/www/apps/docs/content/admin/quickstart.mdx
@@ -165,7 +165,7 @@ You can learn more about the admin dashboard and its features in the [User Guide
 
 ## Multi-Language Support
 
-Medusa supports multiple languages and translations.
+Medusa supports multiple languages and translations. Check out available languages [here](../user-guide/tips/languages.md).
 
 Refer to [this user guide](../user-guide/users/profile.md#change-admin-language) to learn how to switch the language of the Medusa admin.
 
diff --git a/www/apps/docs/content/user-guide.mdx b/www/apps/docs/content/user-guide.mdx
index 1b7b68ba67..3c48236d5d 100644
--- a/www/apps/docs/content/user-guide.mdx
+++ b/www/apps/docs/content/user-guide.mdx
@@ -57,7 +57,7 @@ At the top right you’ll find a <UiIcon lightIcon="https://res.cloudinary.com/d
 
 ### Change Language
 
-The Medusa admin supports multiple-languages, with English being the default one.
+The Medusa admin supports multiple-languages, with English being the default one. Check out available languages [here](./user-guide/tips/languages.md).
 
 Learn how to change the language in [this guide](./user-guide/users/profile.md#change-admin-language).
 
diff --git a/www/apps/docs/content/user-guide/tips/languages.md b/www/apps/docs/content/user-guide/tips/languages.md
new file mode 100644
index 0000000000..65a76ce075
--- /dev/null
+++ b/www/apps/docs/content/user-guide/tips/languages.md
@@ -0,0 +1,36 @@
+# Admin Languages
+
+Medusa Admin comes with multi-language support. This document covers the complete list of available languages, both official and by the community.
+
+:::note
+
+Can't find your language? Learn how you can contribute by translating the admin to other languages [here](../../contribution/admin-translations.md).
+
+:::
+
+## Official Languages
+
+- English
+- French
+- Portuguese
+
+## Community Translations
+
+:::note
+
+Languages listed in this section are contributed by the Medusa community. So, their accuracy is not guaranteed. If you find problems with the translations, please [open an issue in our GitHub repository](https://github.com/medusajs/medusa/issues).
+
+:::
+
+- Bosanski
+- Deutsch
+- Español
+- Hindi
+- Hrvatski
+- Italiano
+- Polski
+- Русский
+- Tamil
+- Tiếng Việt
+- Українська
+- العربية
diff --git a/www/apps/docs/content/user-guide/users/profile.md b/www/apps/docs/content/user-guide/users/profile.md
index ffdd425ba8..f055aef885 100644
--- a/www/apps/docs/content/user-guide/users/profile.md
+++ b/www/apps/docs/content/user-guide/users/profile.md
@@ -42,7 +42,7 @@ The Medusa admin supports multiple languages, and you can change the default lan
 
 :::note
 
-English, French, and Portuguese are the only official translations. Other available languages are contributions from the Medusa community. If you find problems with the translations, please [open an issue in our GitHub repository](https://github.com/medusajs/medusa/issues).
+Some languages are not official, so they may not be accurate. Please refer to [this document](../tips/languages.md) for a full list of official languages and community translations.
 
 :::