Merge branch 'bugfix/remove_shortcut_to_build_instructions_v4.2' into 'release/v4.2'

doc: Getting Started Guide, remove shortcuts to 'build toolchain from scratch' instructions (v4.2)

See merge request espressif/esp-idf!10597

docs/en/get-started/linux-setup.rst

@@ -52,13 +52,4 @@ Next Steps
 To carry on with development environment setup, proceed to :ref:`get-started-get-esp-idf`.
 
 
-Related Documents
-=================
-
-.. toctree::
-    :maxdepth: 1
-
-    :esp32: linux-setup-scratch
-
-
 .. _AUR: https://wiki.archlinux.org/index.php/Arch_User_Repository

docs/en/get-started/macos-setup.rst

@@ -13,10 +13,6 @@ ESP-IDF will use the version of Python installed by default on macOS.
 
     sudo easy_install pip
 
-- install pyserial::
-
-    pip install --user pyserial
-
 - install CMake & Ninja build:
 
   - If you have HomeBrew_, you can run::
@@ -38,21 +34,53 @@ ESP-IDF will use the version of Python installed by default on macOS.
 
    Then you will need to install the XCode command line tools to continue. You can install these by running ``xcode-select --install``.
 
+Installing and setting up Python 3 as default
+---------------------------------------------
+
+Basing on macOS `Catalina 10.15 release notes`_, use of Python 2.7 is not recommended and Python will not be included by default in future versions of macOS. Check what Python you currently have::
+
+  python --version
+
+If the output is like ``Python 2.7.17``, your default interpreter is Python 2.7. If so, also check if Python 3 isn't already installed on your computer::
+
+  python3 --version
+
+If above command returns an error, it means Python 3 is not installed. 
+
+Below is an overview of steps to install Python 3 and making it default interpreter. 
+
+  - Installing with HomeBrew_ can be done as follows::
+
+      brew install python3
+      ln -s /usr/local/bin/python3.8 /usr/local/bin/python
+
+    Adjust above directory name ``/usr/local/bin/python3.8`` to point where Python 3 has been installed. To check this directory you can run  ``which -a python``.
+
+  - If you have MacPorts_, you can run::
+
+      sudo port install python38
+      sudo port select --set python python38
+
+Now open a new terminal session to verify what python is running by default::
+
+  python --version
+
+If the output is similar to ``Python 3.8.5``, your installation has been done successfully.
+
+
+.. note::
+
+    This is system-wide change which may affect all of the applications.
+
 Next Steps
 ==========
 
 To carry on with development environment setup, proceed to :ref:`get-started-get-esp-idf`.
 
-Related Documents
-=================
-
-.. toctree::
-    :maxdepth: 1
-
-    macos-setup-scratch
 
 .. _cmake: https://cmake.org/
 .. _ninja: https://ninja-build.org/
 .. _ccache: https://ccache.samba.org/
 .. _homebrew: https://brew.sh/
 .. _MacPorts: https://www.macports.org/install.php
+.. _Catalina 10.15 release notes: https://developer.apple.com/documentation/macos-release-notes/macos-catalina-10_15-release-notes

docs/en/get-started/windows-setup.rst

@@ -60,9 +60,9 @@ For advanced users who want to customize the install process:
 .. toctree::
     :maxdepth: 1
 
-    windows-setup-scratch
     windows-setup-update
 
+
 .. _MSYS2: https://www.msys2.org/
 .. _cmake: https://cmake.org/download/
 .. _ninja: https://ninja-build.org/

docs/zh_CN/get-started/linux-setup.rst

@@ -38,14 +38,5 @@ Linux 平台工具链的标准设置
 继续设置开发环境，请前往 :ref:`get-started-get-esp-idf` 章节。
 
 
-相关文档
-=================
-
-.. toctree::
-    :maxdepth: 1
-
-    :esp32: linux-setup-scratch
-
-
 .. _AUR: https://wiki.archlinux.org/index.php/Arch_User_Repository
 

docs/zh_CN/get-started/macos-setup.rst

@@ -13,10 +13,6 @@ ESP-IDF 将使用 Mac OS 上默认安装的 Python 版本。
 
     sudo easy_install pip
 
-- 安装 pyserial::
-
-    pip install --user pyserial
-
 - 安装 CMake 和 Ninja 编译工具：
 
     - 若有 HomeBrew_，您可以运行::
@@ -44,13 +40,6 @@ ESP-IDF 将使用 Mac OS 上默认安装的 Python 版本。
 
 继续设置开发环境，请前往 :ref:`get-started-get-esp-idf` 章节。
 
-相关文档
-=================
-
-.. toctree::
-    :maxdepth: 1
-
-    macos-setup-scratch
 
 .. _cmake: https://cmake.org/
 .. _ninja: https://ninja-build.org/

docs/zh_CN/get-started/windows-setup.rst

@@ -60,7 +60,6 @@ ESP-IDF 工具安装器可在“开始”菜单中，创建一个打开 ESP-IDF
 .. toctree::
     :maxdepth: 1
 
-    windows-setup-scratch
     windows-setup-update
 
 .. _MSYS2: https://www.msys2.org/