libretro · fpscan · Nov 8, 2021 · Nov 7, 2021
diff --git a/docs/development/retroarch/new-translations-crowdin.md b/docs/development/retroarch/new-translations-crowdin.md
@@ -69,6 +69,7 @@ Click on any string to see them in the middle area. The **Source String** (the o
 In the very few cases where the source string can be kept as-is, you can click the ‘**Copy Source**’ button ![Copy Source](../../image/development/crowdin-copy-source.png) to do so.
 
 In the string list (on the left side of the screen) some strings have a balloon icon ![Comments icon](../../image/development/crowdin-comments-icon.png). This icon shows that the string has comments written by other translators and developers. Comments may include interesting and/or important information that could help you decide on how best to translate a specific string. You can also write comments in case you have questions or additional information regarding any particular string.
+
 Please make sure that any comment you write is in __English__, as that is the official project language and the comments are visible to _everyone_. Comments will be displayed at Crowdin’s right column. In case there are no comments being displayed there, make sure that the left-most button of that column is active.
 
 <figure markdown>

diff --git a/docs/development/retroarch/new-translations.md b/docs/development/retroarch/new-translations.md
@@ -1,6 +1,6 @@
-# Adding a translation to a new language
+# Adding a new language to RetroArch
 
-## Files you need to change
+## Files to change
 
 * `libretro-common/include/libretro.h`
 * `msg_hash.h`
@@ -96,20 +96,29 @@
 * Be careful when creating and editing your new translation files as some text
   editors do strip the BOM without warning.
 
+### Example: Addition of Arabic language:
+
+* Commit [45580cb](https://github.com/libretro/RetroArch/commit/45580cb9a8f0fcd0a87f00eadf26d87f05289485)
+* Commit [d8f1a08](https://github.com/libretro/RetroArch/commit/d8f1a08a4758851d5530d311303146257cbf8216)
+* Commit [7a0428f](https://github.com/libretro/RetroArch/commit/7a0428fc769fd0eca663207134bec311aa3e30f3)
+
 ### Translation
 
 If you speak the target language xx then you could start translating literals in
 
 * `intl/msg_hash_xx.c`
-* `intl/msg_hash_xx.h`
 
-by replacing the English original ones with its translations.
+by replacing the English original one with its translations.
 
-### Example: Addition of Arabic language:
+The main file for RetroArch is located here:
 
-* Commit [45580cb](https://github.com/libretro/RetroArch/commit/45580cb9a8f0fcd0a87f00eadf26d87f05289485)
-* Commit [d8f1a08](https://github.com/libretro/RetroArch/commit/d8f1a08a4758851d5530d311303146257cbf8216)
-* Commit [7a0428f](https://github.com/libretro/RetroArch/commit/7a0428fc769fd0eca663207134bec311aa3e30f3)
+* `intl/msg_hash_xx.h`
+
+But .h files are periodically updated and overwritten by the Crowdin translations website 
+([Link here](https://crowdin.com/project/retroarch), so it's best to do any changes to 
+non-English languages there. If you want to know more, go to the 
+([Helping with RetroArch translations](https://docs.libretro.com/development/retroarch/new-translations-crowdin/)
+doc.
 
 ## See also
 

diff --git a/docs/image/development/crowdin-approve-button.png b/docs/image/development/crowdin-approve-button.png
diff --git a/docs/image/development/crowdin-comments-icon.png b/docs/image/development/crowdin-comments-icon.png
diff --git a/docs/image/development/crowdin-comments-tab.png b/docs/image/development/crowdin-comments-tab.png
diff --git a/docs/image/development/crowdin-copy-source.png b/docs/image/development/crowdin-copy-source.png
diff --git a/docs/image/development/crowdin-file-selection.png b/docs/image/development/crowdin-file-selection.png
diff --git a/docs/image/development/crowdin-gl-add-term.png b/docs/image/development/crowdin-gl-add-term.png
diff --git a/docs/image/development/crowdin-gl-edit-term.png b/docs/image/development/crowdin-gl-edit-term.png
diff --git a/docs/image/development/crowdin-gl-terms-add.png b/docs/image/development/crowdin-gl-terms-add.png
diff --git a/docs/image/development/crowdin-gl-terms.png b/docs/image/development/crowdin-gl-terms.png
diff --git a/docs/image/development/crowdin-gl-translation.png b/docs/image/development/crowdin-gl-translation.png
diff --git a/docs/image/development/crowdin-join.png b/docs/image/development/crowdin-join.png
diff --git a/docs/image/development/crowdin-line-break.png b/docs/image/development/crowdin-line-break.png
diff --git a/docs/image/development/crowdin-other-languages.png b/docs/image/development/crowdin-other-languages.png
diff --git a/docs/image/development/crowdin-placeholder-special.png b/docs/image/development/crowdin-placeholder-special.png
diff --git a/docs/image/development/crowdin-placeholders.png b/docs/image/development/crowdin-placeholders.png
diff --git a/docs/image/development/crowdin-previously-translated-as.png b/docs/image/development/crowdin-previously-translated-as.png
diff --git a/docs/image/development/crowdin-sign-up.png b/docs/image/development/crowdin-sign-up.png
diff --git a/docs/image/development/crowdin-suggested-translations.png b/docs/image/development/crowdin-suggested-translations.png
diff --git a/docs/image/development/crowdin-tm-search.png b/docs/image/development/crowdin-tm-search.png
diff --git a/docs/image/development/crowdin-tm.png b/docs/image/development/crowdin-tm.png
diff --git a/docs/image/development/crowdin-translate-page.png b/docs/image/development/crowdin-translate-page.png
diff --git a/docs/image/development/crowdin-translation-page.png b/docs/image/development/crowdin-translation-page.png
diff --git a/docs/image/development/retropad-conceptual-diagram.png b/docs/image/development/retropad-conceptual-diagram.png
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -303,8 +303,8 @@ nav:
         - 'Input Driver Specification': 'development/retroarch/input/input-drivers.md'
         - 'Input Overlays': 'development/retroarch/input/overlay.md'
         - 'Parallel Port Controllers': 'development/retroarch/input/parallel-port-controllers.md'
-      - 'Adding Translations(not active)': 'development/retroarch/new-translations.md'
-      - 'Adding Translations with Crowdin': 'development/retroarch/new-translations-crowdin.md'
+      - 'Adding New Languages or New Strings': 'development/retroarch/new-translations.md'
+      - 'Helping with RetroArch translations': 'development/retroarch/new-translations-crowdin.md'
       - 'Network Protocols':
         - 'Netplay': 'development/retroarch/netplay.md'
         - 'Network Control Interface': 'development/retroarch/network-control-interface.md'