[Docs] fix docs (#7642)

* [Docs] recurse-submodules option is need now

* [Docs] `tmk_core` folder is correct

* [Docs] fix typo

* [Docs] package scope has changed

* [Docs] Fix menu differences

* Update docs/arm_debugging.md

Co-Authored-By: fauxpark <fauxpark@gmail.com>

* Update docs/arm_debugging.md

Co-Authored-By: fauxpark <fauxpark@gmail.com>

* fix typo

Co-authored-by: fauxpark <fauxpark@gmail.com>

12 files changed, 109 insertions, 73 deletions

diff --git a/docs/arm_debugging.md b/docs/arm_debugging.md
index 448b7a8fcc..04887d88b7 100644
--- a/docs/arm_debugging.md
+++ b/docs/arm_debugging.md
@@ -1,4 +1,4 @@
-# ARM Debugging usign Eclipse
+# ARM Debugging using Eclipse
 
 This page describes how to setup debugging for ARM MCUs using an SWD adapter and open-source/free tools. In this guide we will install GNU MCU Eclipse IDE for C/C++ Developers and OpenOCD together with all the necessary dependencies.
 
@@ -18,7 +18,7 @@ XPM installation instructions can be found [here](https://www.npmjs.com/package/
 
 ### The ARM Toolchain
 
-Using XPM it is very easy to install the ARM toolchain. Enter the command `xpm install --global @gnu-mcu-eclipse/arm-none-eabi-gcc`.
+Using XPM it is very easy to install the ARM toolchain. Enter the command `xpm install --global @xpack-dev-tools/arm-none-eabi-gcc`.
 
 ### Windows build tools
 
@@ -33,7 +33,7 @@ If you have an ST-Link the drivers can be found [here](https://www.st.com/en/dev
 
 ### OpenOCD
 
-This dependency allows SWD access from GDB and it is essential for debugging. Run `xpm install --global @gnu-mcu-eclipse/openocd`.
+This dependency allows SWD access from GDB and it is essential for debugging. Run `xpm install --global @xpack-dev-tools/openocd`.
 
 ### Java
 
@@ -45,17 +45,17 @@ Now its finally time to install the IDE. Use the Release page [here](https://git
 
 ## Configuring Eclipse
 
-Open up the Eclipse IDE we just downloaded. To import our QMK directory select File -> Import -> C/C++ -> Existing code as Makefile Project. Select next and use Browse to select your QMK folder. In the tool-chain list select ARM Cross GCC and select Finish.
+Open up the Eclipse IDE we just downloaded. To import our QMK directory select File -> Import -> C/C++ -> Existing Code as Makefile Project. Select Next and use Browse to select your QMK folder. In the tool-chain list select ARM Cross GCC and select Finish.
 
-Now you can see the QMK folder on the left hand side. Right click it and select Properties. On the left hand side, expand MCU and select ARM Toolchain Paths. Press xPack and OK. Repeat for OpenOCD Path  and if you are on windows for Build Tool Path. Select Apply and Close.
+Now you can see the QMK folder on the left hand side. Right click it and select Properties. On the left hand side, expand MCU and select ARM Toolchains Paths. Press xPack and OK. Repeat for OpenOCD Path and if you are on Windows for Build Tools Path. Select Apply and Close.
 
-Now its time to install the necessary MCU packages. Go to Packs perspective by selecting Window -> Open Perspective -> Others -> Packs. Now select the yellow refresh symbol next to the Packs tab. This will take a long time as it is requesting the MCU definitions from various places. If some of the links fail you can probably select Ignore.
+Now its time to install the necessary MCU packages. Go to Packs perspective by selecting Window -> Perspective -> Open Perspective -> Other... -> Packs. Now select the yellow refresh symbol next to the Packs tab. This will take a long time as it is requesting the MCU definitions from various places. If some of the links fail you can probably select Ignore.
 
-When this finishes you must find the MCU which we will be building/debugging for. In this example I will be using the STM32F3 series MCUs. On the left, select STMicroelectonics -> STM32F3 Series. On the middle window we can see the pack. Right click and select Install. Once that is done we can go back to the default perspective, Window -> Open Perspective -> Others -> C/C++.
+When this finishes you must find the MCU which we will be building/debugging for. In this example I will be using the STM32F3 series MCUs. On the left, select STMicroelectronics -> STM32F3 Series. On the middle window we can see the pack. Right click and select Install. Once that is done we can go back to the default perspective, Window -> Perspective -> Open Perspective -> Other... -> C/C++.
 
-We need to let eclipse know the device we intent to build QMK on. Right click on the QMK folder -> Properties -> C/C++ Build -> Settings. Select the Devices tab and under devices select the appropriate variant of your MCU. For my example it is STM32F303CC
+We need to let eclipse know the device we intent to build QMK on. Right click on the QMK folder -> Properties -> C/C++ Build -> Settings. Select the Devices tab and under Devices select the appropriate variant of your MCU. For my example it is STM32F303CC
 
-While we are here let's setup the build command as well. Select C/C++ Build and then the Behavior tab. On the build command, replace `all` with your necessary make command. For example for a rev6 Planck with the default keymap this would be `planck/rev6:default`. Select Apply and Close.
+While we are here let's setup the build command as well. Select C/C++ Build and then the Behavior tab. On the Build command, replace `all` with your necessary make command. For example for a rev6 Planck with the default keymap this would be `planck/rev6:default`. Select Apply and Close.
 
 ## Building
 
@@ -71,7 +71,7 @@ NOTE: Make sure the SWCLK and SWDIO pins are not used in the matrix of your keyb
 
 ### Configuring the Debugger
 
-Right click on your QMK folder, select Debug As -> Debug Configuration. Here double click on GDB OpenOCD Debugging. Select the debugger tab and enter the configuration necessary for your MCU. This might take some fiddling and googleing to find out. The default script for the STM32F3 is called stm32f3discovery.cfg. To let OpenOCD know, in the Config options enter `-f board/stm32f3discovery.cfg`.
+Right click on your QMK folder, select Debug As -> Debug Configurations... . Here double click on GDB OpenOCD Debugging. Select the Debugger tab and enter the configuration necessary for your MCU. This might take some fiddling and Googling to find out. The default script for the STM32F3 is called `stm32f3discovery.cfg`. To let OpenOCD know, in the Config options enter `-f board/stm32f3discovery.cfg`.
 
 NOTE: In my case this configuration script requires editing to disable the reset assertion. The locations of the scripts can be found in the actual executable field usually under the path `openocd/version/.content/scripts/board`. Here I edited `reset_config srst_only` to `reset_config none`.
 
@@ -81,7 +81,7 @@ Select Apply and Close.
 
 Reset your keyboard.
 
-Press the bug icon and if all goes well you should soon find yourself in the debug perspective. Here the program counter will pause at the beginning of the main function and way for you to press Play. Most of the features of all debuggers work on ARM MCUs but for exact details google is your friend!
+Press the bug icon and if all goes well you should soon find yourself in the Debug perspective. Here the program counter will pause at the beginning of the main function and wait for you to press Play. Most of the features of all debuggers work on Arm MCUs but for exact details Google is your friend!
 
 
 Happy debugging!
diff --git a/docs/fr-fr/getting_started_github.md b/docs/fr-fr/getting_started_github.md
index 22c6ee749b..48755625a7 100644
--- a/docs/fr-fr/getting_started_github.md
+++ b/docs/fr-fr/getting_started_github.md
@@ -16,17 +16,23 @@ Faites attention à sélectionner "HTTPS", et sélectionnez le lien et copiez-le
 
 ![HTTPS link](http://i.imgur.com/eGO0ohO.jpg)
 
-Ensuite, entrez `git clone` dans la ligne de commande, et collez votre lien:
+Ensuite, entrez `git clone --recurse-submodules ` dans la ligne de commande, et collez votre lien:
 
 ```
-user@computer:~$ git clone https://github.com/whoeveryouare/qmk_firmware.git
+user@computer:~$ git clone --recurse-submodules https://github.com/whoeveryouare/qmk_firmware.git
 Cloning into 'qmk_firmware'...
-remote: Counting objects: 46625, done.
-remote: Compressing objects: 100% (2/2), done.
-remote: Total 46625 (delta 0), reused 0 (delta 0), pack-reused 46623
-Receiving objects: 100% (46625/46625), 84.47 MiB | 3.14 MiB/s, done.
-Resolving deltas: 100% (29362/29362), done.
-Checking out files: 100% (2799/2799), done.
+remote: Enumerating objects: 9, done.
+remote: Counting objects: 100% (9/9), done.
+remote: Compressing objects: 100% (5/5), done.
+remote: Total 183883 (delta 5), reused 4 (delta 4), pack-reused 183874
+Receiving objects: 100% (183883/183883), 132.90 MiB | 9.57 MiB/s, done.
+Resolving deltas: 100% (119972/119972), done.
+...
+Submodule path 'lib/chibios': checked out '587968d6cbc2b0e1c7147540872f2a67e59ca18b'
+Submodule path 'lib/chibios-contrib': checked out 'ede48346eee4b8d6847c19bc01420bee76a5e486'
+Submodule path 'lib/googletest': checked out 'ec44c6c1675c25b9827aacd08c02433cccde7780'
+Submodule path 'lib/lufa': checked out 'ce10f7642b0459e409839b23cc91498945119b4d'
+Submodule path 'lib/ugfx': checked out '3e97b74e03c93631cdd3ddb2ce43b963fdce19b2'
 ```
 
 Vous avez maintenant votre fork QMK sur votre machine locale, vous pouvez ajouter votre keymap, la compiler et la flasher sur votre board. Une fois heureux avec vos changements, vous pouvez les ajouter, commit, et pousser vers votre fork comme suit:
diff --git a/docs/fr-fr/getting_started_introduction.md b/docs/fr-fr/getting_started_introduction.md
index a7f0ff96af..b2711a1671 100644
--- a/docs/fr-fr/getting_started_introduction.md
+++ b/docs/fr-fr/getting_started_introduction.md
@@ -4,7 +4,7 @@ Le but de cette page est d'expliquer les informations de base qui vous serons nÃ
 
 ## Structure de base de QMK
 
-QMK est un fork du projet [tmk_keyboard](https://github.com/tmk/tmk_keyboard) créé par [Jun Wako](https://github.com/tmk). Le code originel de TMK, avec quelques modifications, se trouve dans le dossier `tmk`. Les additions que QMK amène au projet se trouvent dans le dossier `quantum`. Les projets de clavier se trouvent dans les dossiers `handwired` et `keyboard`.
+QMK est un fork du projet [tmk_keyboard](https://github.com/tmk/tmk_keyboard) créé par [Jun Wako](https://github.com/tmk). Le code originel de TMK, avec quelques modifications, se trouve dans le dossier `tmk_core`. Les additions que QMK amène au projet se trouvent dans le dossier `quantum`. Les projets de clavier se trouvent dans les dossiers `handwired` et `keyboard`.
 
 ### Structure du Userspace
 
diff --git a/docs/getting_started_github.md b/docs/getting_started_github.md
index 629f4ece26..07f523f578 100644
--- a/docs/getting_started_github.md
+++ b/docs/getting_started_github.md
@@ -16,17 +16,23 @@ And be sure to select "HTTPS", and select the link and copy it:
 
 ![HTTPS link](http://i.imgur.com/eGO0ohO.jpg)
 
-From here, enter `git clone ` into the command line, and then paste your link:
+From here, enter `git clone --recurse-submodules ` into the command line, and then paste your link:
 
 ```
 user@computer:~$ git clone --recurse-submodules https://github.com/whoeveryouare/qmk_firmware.git
 Cloning into 'qmk_firmware'...
-remote: Counting objects: 46625, done.
-remote: Compressing objects: 100% (2/2), done.
-remote: Total 46625 (delta 0), reused 0 (delta 0), pack-reused 46623
-Receiving objects: 100% (46625/46625), 84.47 MiB | 3.14 MiB/s, done.
-Resolving deltas: 100% (29362/29362), done.
-Checking out files: 100% (2799/2799), done.
+remote: Enumerating objects: 9, done.
+remote: Counting objects: 100% (9/9), done.
+remote: Compressing objects: 100% (5/5), done.
+remote: Total 183883 (delta 5), reused 4 (delta 4), pack-reused 183874
+Receiving objects: 100% (183883/183883), 132.90 MiB | 9.57 MiB/s, done.
+Resolving deltas: 100% (119972/119972), done.
+...
+Submodule path 'lib/chibios': checked out '587968d6cbc2b0e1c7147540872f2a67e59ca18b'
+Submodule path 'lib/chibios-contrib': checked out 'ede48346eee4b8d6847c19bc01420bee76a5e486'
+Submodule path 'lib/googletest': checked out 'ec44c6c1675c25b9827aacd08c02433cccde7780'
+Submodule path 'lib/lufa': checked out 'ce10f7642b0459e409839b23cc91498945119b4d'
+Submodule path 'lib/ugfx': checked out '3e97b74e03c93631cdd3ddb2ce43b963fdce19b2'
 ```
 
 You now have your QMK fork on your local machine, and you can add your keymap, compile it and flash it to your board. Once you're happy with your changes, you can add, commit, and push them to your fork like this:
diff --git a/docs/he-il/getting_started_github.md b/docs/he-il/getting_started_github.md
index 55602c8142..e5d0f7c782 100644
--- a/docs/he-il/getting_started_github.md
+++ b/docs/he-il/getting_started_github.md
@@ -17,19 +17,25 @@ Github עלול להיות קצת טריקי למי של×� מכיר ×�ת העב×
 
 ![קישור HTTPS](http://i.imgur.com/eGO0ohO.jpg)
 
-מכ�ן והל�ה, הקיש `git clone ` בשורת הפקודה והדביקו �ת הלינק שלכ�:
+מכ�ן והל�ה, הקיש `git clone --recurse-submodules ` בשורת הפקודה והדביקו �ת הלינק שלכ�:
 
 <div dir="ltr" markdown="1">
 
 ```
-user@computer:~$ git clone https://github.com/whoeveryouare/qmk_firmware.git
+user@computer:~$ git clone --recurse-submodules https://github.com/whoeveryouare/qmk_firmware.git
 Cloning into 'qmk_firmware'...
-remote: Counting objects: 46625, done.
-remote: Compressing objects: 100% (2/2), done.
-remote: Total 46625 (delta 0), reused 0 (delta 0), pack-reused 46623
-Receiving objects: 100% (46625/46625), 84.47 MiB | 3.14 MiB/s, done.
-Resolving deltas: 100% (29362/29362), done.
-Checking out files: 100% (2799/2799), done.
+remote: Enumerating objects: 9, done.
+remote: Counting objects: 100% (9/9), done.
+remote: Compressing objects: 100% (5/5), done.
+remote: Total 183883 (delta 5), reused 4 (delta 4), pack-reused 183874
+Receiving objects: 100% (183883/183883), 132.90 MiB | 9.57 MiB/s, done.
+Resolving deltas: 100% (119972/119972), done.
+...
+Submodule path 'lib/chibios': checked out '587968d6cbc2b0e1c7147540872f2a67e59ca18b'
+Submodule path 'lib/chibios-contrib': checked out 'ede48346eee4b8d6847c19bc01420bee76a5e486'
+Submodule path 'lib/googletest': checked out 'ec44c6c1675c25b9827aacd08c02433cccde7780'
+Submodule path 'lib/lufa': checked out 'ce10f7642b0459e409839b23cc91498945119b4d'
+Submodule path 'lib/ugfx': checked out '3e97b74e03c93631cdd3ddb2ce43b963fdce19b2'
 ```
 
 </div>
@@ -66,4 +72,4 @@ To https://github.com/whoeveryouare/qmk_firmware.git
 ![צרו Pull Request](http://i.imgur.com/Ojydlaj.jpg)
 
 �חרי שהגשת�, �נו עלולי� לפנות �ליכ� לגבי השינויי� שהצעת�, נבקש שתבצעו שינויי� ובסופו של דבר נקבל �ת השינויי�! תודה שתרמת� לפרוייקט QMK :)
-</div>
\ No newline at end of file
+</div>
diff --git a/docs/he-il/getting_started_introduction.md b/docs/he-il/getting_started_introduction.md
index 4b7f56b2a7..fca86bdaaf 100644
--- a/docs/he-il/getting_started_introduction.md
+++ b/docs/he-il/getting_started_introduction.md
@@ -5,7 +5,7 @@
 
 ## מבנה QMK בסיסי
 
-QMK הו� פורק של הפרוייקט [tmk_keyboard](https://github.com/tmk/tmk_keyboard) של [Jun Wako](https://github.com/tmk). קוד הTMK המקורי, ע� הת�מות, יכול להמצ� בתיקיית `tmk`. התוספות של QMK לפרוייקט יכולות להמצ� בתיקיית `quantum`. פרוייקטי מקלדות יכולות להמצ� בתיקיות `handwired` ו- `keyboard`.
+QMK הו� פורק של הפרוייקט [tmk_keyboard](https://github.com/tmk/tmk_keyboard) של [Jun Wako](https://github.com/tmk). קוד הTMK המקורי, ע� הת�מות, יכול להמצ� בתיקיית `tmk_core`. התוספות של QMK לפרוייקט יכולות להמצ� בתיקיית `quantum`. פרוייקטי מקלדות יכולות להמצ� בתיקיות `handwired` ו- `keyboard`.
 
 ### מבנה �חסון המשתמש
 
@@ -69,4 +69,4 @@ In every keymap folder, the following files may be found. Only `keymap.c` is req
 ```
 
 </div>
-</div>
\ No newline at end of file
+</div>
diff --git a/docs/ja/arm_debugging.md b/docs/ja/arm_debugging.md
index 5b7b89a678..27eddbfdf1 100644
--- a/docs/ja/arm_debugging.md
+++ b/docs/ja/arm_debugging.md
@@ -23,7 +23,7 @@ XPM �インストール手順�[��](https://www.npmjs.com/package/xpm)�
 
 ### ARM ツール�ェーン
 
-XPM を使���ARM ツール�ェーンを��も簡��インストール����。`xpm install --global @gnu-mcu-eclipse/arm-none-eabi-gcc` �コマンドを入力���。
+XPM を使���ARM ツール�ェーンを��も簡��インストール����。`xpm install --global @xpack-dev-tools/arm-none-eabi-gcc` �コマンドを入力���。
 
 ### Windows ビルドツール
 
@@ -38,7 +38,7 @@ ST-Link を����る場���ドライ��[��](https://www.st.com
 
 ### OpenOCD
 
-���存関係�より�SWD � GDB �らアクセス���デ�ッグ���欠��。`xpm install --global @gnu-mcu-eclipse/openocd` を実行���。
+���存関係�より�SWD � GDB �らアクセス���デ�ッグ���欠��。`xpm install --global @xpack-dev-tools/openocd` を実行���。
 
 ### Java
 
@@ -50,17 +50,17 @@ Java � Eclipse �必���れる���[��](https://www.oracle.com/t
 
 ## Eclipse �設定
 
-ダウンロード�� Eclipse IDE を開���。QMK ディレクトリをイン�ート�る����File -> Import -> C/C++ -> Existing code as Makefile Project を�択���。Next を�択��Browse を使用�� QMK フォルダを�択���。tool-chain リスト�ら ARM Cross GCC を�択��Finish を�択���。
+ダウンロード�� Eclipse IDE を開���。QMK ディレクトリをイン�ート�る����File -> Import -> C/C++ -> Existing Code as Makefile Project を�択���。Next を�択��Browse を使用�� QMK フォルダを�択���。tool-chain リスト�ら ARM Cross GCC を�択��Finish を�択���。
 
-�れ��左�� QMK フォルダ�表示�れ��。�クリック���Properties を�択���。左�� MCU を展開��ARM Toolchain Paths を�択���。xPack を押�� OK を押���。OpenOCD Path �����を繰り返��Windows �場���Build Tool Path �も����を繰り返���。Apply and Close を�択���。
+�れ��左�� QMK フォルダ�表示�れ��。�クリック���Properties を�択���。左�� MCU を展開��ARM Toolchains Paths を�択���。xPack を押�� OK を押���。OpenOCD Path �����を繰り返��Windows �場���Build Tools Path �も����を繰り返���。Apply and Close を�択���。
 
-����必�� MCU パッケージをインストール���。Window -> Open Perspective -> Others -> Packs を�択���Packs perspective �移動���。Packs タブ�横��る黄色�リフレッシュ記�を�択���。�れ�様々�場所�ら MCU �定義を�求�る���時間�掛�り��。一部�リンク�失敗��場�����ら� Ignore を�択����。
+����必�� MCU パッケージをインストール���。Window -> Perspective -> Open Perspective -> Other... -> Packs を�択���Packs perspective �移動���。Packs タブ�横��る黄色�リフレッシュ記�を�択���。�れ�様々�場所�ら MCU �定義を�求�る���時間�掛�り��。一部�リンク�失敗��場�����ら� Ignore を�択����。
 
-�れ�終了�る��ビルドやデ�ッグ�る MCU を見��る�����る����。��例���STM32F3 シリーズ� MCU を使���。左���STMicroelectronics -> STM32F3 Series を�択���。中央�ウィンドウ��pack �表示�れ��。�クリック��Install を�択���。�れ�終了��ら�Window -> Open Perspective -> Others -> C/C++ を�択��デフォルト�パースペクティブ�戻る�������。
+�れ�終了�る��ビルドやデ�ッグ�る MCU を見��る�����る����。��例���STM32F3 シリーズ� MCU を使���。左���STMicroelectronics -> STM32F3 Series を�択���。中央�ウィンドウ��pack �表示�れ��。�クリック��Install を�択���。�れ�終了��ら�Window -> Perspective -> Open Perspective -> Other... -> C/C++ を�択��デフォルト�パースペクティブ�戻る�������。
 
-Eclipse � QMK をビルド�よ���るデ�イスを教�る必���り��。QMK フォルダを�クリック -> Properties -> C/C++ Build -> Settings を�択���。Devices タブを�択��devices �下�ら MCU ��切�種類を�択���。��例���STM32F303CC ��。
+Eclipse � QMK をビルド�よ���るデ�イスを教�る必���り��。QMK フォルダを�クリック -> Properties -> C/C++ Build -> Settings を�択���。Devices タブを�択��Devices �下�ら MCU ��切�種類を�択���。��例���STM32F303CC ��。
 
-��間��build コマンドもセットアップ���ょ�。C/C++ Build を�択��Behavior タブを�択���。build コマンド������`all` を必�� make コマンド�置�����。例���rev6 Planck � default キーマップ�場���れ� `planck/rev6:default` ��り��。Apply and Close を�択���。
+��間��Build コマンドもセットアップ���ょ�。C/C++ Build を�択��Behavior タブを�択���。build コマンド������`all` を必�� make コマンド�置�����。例���rev6 Planck � default キーマップ�場���れ� `planck/rev6:default` ��り��。Apply and Close を�択���。
 
 ## ビルド
 
@@ -76,7 +76,7 @@ ARM MCU ã�¯ã€�クロック信å�·(SWCLK) ã�¨ãƒ‡ãƒ¼ã‚¿ä¿¡å�·(SWDIO) ã�§æ§‹æˆ�ã�•ã‚
 
 ### デ�ッガ�設定
 
-QMK フォルダを�クリック��Debug As -> Debug Configuration を�択���。����GDB OpenOCD Debugging をダブルクリック���。Debugger タブを�択��MCU �必��設定を入力���。�れを見��る������りググ��り�る必���る�も�れ��ん。STM32F3 用�デフォルトスクリプト� stm32f3discovery.cfg �呼�れ��。OpenOCD ���る���Config options � `-f board/stm32f3discovery.cfg` �入力���。
+QMK フォルダを�クリック��Debug As -> Debug Configurations... を�択���。����GDB OpenOCD Debugging をダブルクリック���。Debugger タブを�択��MCU �必��設定を入力���。�れを見��る������りググ��り�る必���る�も�れ��ん。STM32F3 用�デフォルトスクリプト� stm32f3discovery.cfg �呼�れ��。OpenOCD ���る���Config options � `-f board/stm32f3discovery.cfg` �入力���。
 
 注�: ��場����設定スクリプト�リセット�作を無効��る���編集�必���。スクリプト�場所��通常�パス `openocd/version/.content/scripts/board` �下�実際�実行�能フィールド�中�見��り��。������ `reset_config srst_only` を `reset_config none` �編集����。
 
@@ -86,7 +86,7 @@ Apply and Close を�択���。
 
 キーボードをリセット������。
 
-虫アイコンをクリック��も�全����行�� debug パースペクティブ�移動���。�����main 関数�最��プログラムカウンタ��止�る���Play ボタンを押���。全��デ�ッガ���ん��機能� ARM MCU �動作�����正確�詳細����� google �����������
+虫アイコンをクリック��も�全����行�� Debug パースペクティブ�移動���。�����main 関数�最��プログラムカウンタ��止�る���Play ボタンを押���。全��デ�ッガ���ん��機能� ARM MCU �動作�����正確�詳細����� google �����������
 
 
 �ッピーデ�ッギング�
diff --git a/docs/ja/getting_started_github.md b/docs/ja/getting_started_github.md
index e7af36efa4..0d08ab78b7 100644
--- a/docs/ja/getting_started_github.md
+++ b/docs/ja/getting_started_github.md
@@ -21,17 +21,23 @@ Github ã�¯æ…£ã‚Œã�¦ã�„ã�ªã�„人ã�«ã�¯å°‘ã�—注æ„�ã�Œå¿…è¦�ã�§ã�™ - ã�“ã�®ã‚¬ã‚¤ã
 
 ![HTTPS リンク](http://i.imgur.com/eGO0ohO.jpg)
 
-���ら�`git clone` をコマンドライン�入力��リンクを貼り付���:
+���ら�`git clone --recurse-submodules ` をコマンドライン�入力��リンクを貼り付���:
 
 ```
 user@computer:~$ git clone --recurse-submodules https://github.com/whoeveryouare/qmk_firmware.git
 Cloning into 'qmk_firmware'...
-remote: Counting objects: 46625, done.
-remote: Compressing objects: 100% (2/2), done.
-remote: Total 46625 (delta 0), reused 0 (delta 0), pack-reused 46623
-Receiving objects: 100% (46625/46625), 84.47 MiB | 3.14 MiB/s, done.
-Resolving deltas: 100% (29362/29362), done.
-Checking out files: 100% (2799/2799), done.
+remote: Enumerating objects: 9, done.
+remote: Counting objects: 100% (9/9), done.
+remote: Compressing objects: 100% (5/5), done.
+remote: Total 183883 (delta 5), reused 4 (delta 4), pack-reused 183874
+Receiving objects: 100% (183883/183883), 132.90 MiB | 9.57 MiB/s, done.
+Resolving deltas: 100% (119972/119972), done.
+...
+Submodule path 'lib/chibios': checked out '587968d6cbc2b0e1c7147540872f2a67e59ca18b'
+Submodule path 'lib/chibios-contrib': checked out 'ede48346eee4b8d6847c19bc01420bee76a5e486'
+Submodule path 'lib/googletest': checked out 'ec44c6c1675c25b9827aacd08c02433cccde7780'
+Submodule path 'lib/lufa': checked out 'ce10f7642b0459e409839b23cc91498945119b4d'
+Submodule path 'lib/ugfx': checked out '3e97b74e03c93631cdd3ddb2ce43b963fdce19b2'
 ```
 
 ローカルマシン� QMK �フォーク���る���キーマップ�追加�コンパイル�キーボード��書�込������。変更�満足��ら�以下�よ���れらをフォーク�追加�コミット�よ�プッシュ�る�������:
diff --git a/docs/ru-ru/getting_started_github.md b/docs/ru-ru/getting_started_github.md
index 8a0fd07a27..3b4940dd15 100644
--- a/docs/ru-ru/getting_started_github.md
+++ b/docs/ru-ru/getting_started_github.md
@@ -15,17 +15,23 @@ GitHub может показать�� не�колько �ложным дл�
 
 ![HTTPS link](http://i.imgur.com/eGO0ohO.jpg)
 
-Теперь введите `git clone` в командную �троку, а затем в�тавьте ��ылку:
+Теперь введите `git clone --recurse-submodules ` в командную �троку, а затем в�тавьте ��ылку:
 
 ```
-user@computer:~$ git clone https://github.com/whoeveryouare/qmk_firmware.git
+user@computer:~$ git clone --recurse-submodules https://github.com/whoeveryouare/qmk_firmware.git
 Cloning into 'qmk_firmware'...
-remote: Counting objects: 46625, done.
-remote: Compressing objects: 100% (2/2), done.
-remote: Total 46625 (delta 0), reused 0 (delta 0), pack-reused 46623
-Receiving objects: 100% (46625/46625), 84.47 MiB | 3.14 MiB/s, done.
-Resolving deltas: 100% (29362/29362), done.
-Checking out files: 100% (2799/2799), done.
+remote: Enumerating objects: 9, done.
+remote: Counting objects: 100% (9/9), done.
+remote: Compressing objects: 100% (5/5), done.
+remote: Total 183883 (delta 5), reused 4 (delta 4), pack-reused 183874
+Receiving objects: 100% (183883/183883), 132.90 MiB | 9.57 MiB/s, done.
+Resolving deltas: 100% (119972/119972), done.
+...
+Submodule path 'lib/chibios': checked out '587968d6cbc2b0e1c7147540872f2a67e59ca18b'
+Submodule path 'lib/chibios-contrib': checked out 'ede48346eee4b8d6847c19bc01420bee76a5e486'
+Submodule path 'lib/googletest': checked out 'ec44c6c1675c25b9827aacd08c02433cccde7780'
+Submodule path 'lib/lufa': checked out 'ce10f7642b0459e409839b23cc91498945119b4d'
+Submodule path 'lib/ugfx': checked out '3e97b74e03c93631cdd3ddb2ce43b963fdce19b2'
 ```
 
 Теперь у ва� е�ть форк QMK на вашем локальном компьютере, и вы можете добавить �вою ра�кладку, �компилировать ее и прошить ей �вою клавиатуру. Как только вы будете довольны �воими изменени�ми, е�ть возможно�ть добавить, зафик�ировать их и �делать коммит в �вой форк �ледующим образом:
diff --git a/docs/ru-ru/getting_started_introduction.md b/docs/ru-ru/getting_started_introduction.md
index 142fe4254a..ccc4418068 100644
--- a/docs/ru-ru/getting_started_introduction.md
+++ b/docs/ru-ru/getting_started_introduction.md
@@ -4,7 +4,7 @@
 
 ## Базова� �труктура QMK
 
-QMK - �то форк [Джуна Вако (Jun Wako)](https://github.com/tmk) проекта [tmk_keyboard](https://github.com/tmk/tmk_keyboard). Оригинальный код TMK � изменени�ми можно найти в папке `tmk`. Дополнени� QMK к проекту можно найти в папке `quantum`. Проекты клавиатур можно найти в папках `handwired` и `keyboard`.
+QMK - �то форк [Джуна Вако (Jun Wako)](https://github.com/tmk) проекта [tmk_keyboard](https://github.com/tmk/tmk_keyboard). Оригинальный код TMK � изменени�ми можно найти в папке `tmk_core`. Дополнени� QMK к проекту можно найти в папке `quantum`. Проекты клавиатур можно найти в папках `handwired` и `keyboard`.
 
 ### Структура про�тран�тва пользовател�
 
diff --git a/docs/zh-cn/getting_started_github.md b/docs/zh-cn/getting_started_github.md
index 0400eea643..2b2f7a75c5 100644
--- a/docs/zh-cn/getting_started_github.md
+++ b/docs/zh-cn/getting_started_github.md
@@ -16,17 +16,23 @@ Github can be a little tricky to those that aren't familiar with it - this guide
 
 ![HTTPS链接](http://i.imgur.com/eGO0ohO.jpg)
 
-然�，在命令行输入`git clone `，然�粘贴你的链接:
+然�，在命令行输入`git clone --recurse-submodules `，然�粘贴你的链接:
 
 ```
-user@computer:~$ git clone https://github.com/whoeveryouare/qmk_firmware.git
+user@computer:~$ git clone --recurse-submodules https://github.com/whoeveryouare/qmk_firmware.git
 Cloning into 'qmk_firmware'...
-remote: Counting objects: 46625, done.
-remote: Compressing objects: 100% (2/2), done.
-remote: Total 46625 (delta 0), reused 0 (delta 0), pack-reused 46623
-Receiving objects: 100% (46625/46625), 84.47 MiB | 3.14 MiB/s, done.
-Resolving deltas: 100% (29362/29362), done.
-Checking out files: 100% (2799/2799), done.
+remote: Enumerating objects: 9, done.
+remote: Counting objects: 100% (9/9), done.
+remote: Compressing objects: 100% (5/5), done.
+remote: Total 183883 (delta 5), reused 4 (delta 4), pack-reused 183874
+Receiving objects: 100% (183883/183883), 132.90 MiB | 9.57 MiB/s, done.
+Resolving deltas: 100% (119972/119972), done.
+...
+Submodule path 'lib/chibios': checked out '587968d6cbc2b0e1c7147540872f2a67e59ca18b'
+Submodule path 'lib/chibios-contrib': checked out 'ede48346eee4b8d6847c19bc01420bee76a5e486'
+Submodule path 'lib/googletest': checked out 'ec44c6c1675c25b9827aacd08c02433cccde7780'
+Submodule path 'lib/lufa': checked out 'ce10f7642b0459e409839b23cc91498945119b4d'
+Submodule path 'lib/ugfx': checked out '3e97b74e03c93631cdd3ddb2ce43b963fdce19b2'
 ```
 
 现在你本地计算机有QMK的分�了,你�以添加你的布局了, 为你的键盘编译并刷新固件�。如果你觉得你的修改很�错, 你�以添加,�交,然�想你的分�推出（pull）你的改�，�这样:
diff --git a/docs/zh-cn/getting_started_introduction.md b/docs/zh-cn/getting_started_introduction.md
index dcd0b72a56..b977b63390 100644
--- a/docs/zh-cn/getting_started_introduction.md
+++ b/docs/zh-cn/getting_started_introduction.md
@@ -4,7 +4,7 @@
 
 ## 基本QMK结构
 
-QMK是[Jun Wako](https://github.com/tmk)的[tmk_keyboard](https://github.com/tmk/tmk_keyboard)工程的一个分�。�过更改的TMK原始代�放在`tmk` 文件夹中。 QMK增加的新东西�以在 `quantum` 文件夹中找到。 键盘项目�以在 `handwired`（手动飞线） 和 `keyboard`（PCB键盘）这两个文件夹找到。
+QMK是[Jun Wako](https://github.com/tmk)的[tmk_keyboard](https://github.com/tmk/tmk_keyboard)工程的一个分�。�过更改的TMK原始代�放在`tmk_core` 文件夹中。 QMK增加的新东西�以在 `quantum` 文件夹中找到。 键盘项目�以在 `handwired`（手动飞线） 和 `keyboard`（PCB键盘）这两个文件夹找到。
 
 ### 用户空间结构