docs: Add some clarifications for Mac OS users

diff --git a/docs/en/get-started/establish-serial-connection.rst b/docs/en/get-started/establish-serial-connection.rst
index 363de1cceef6f2810db8cfe7e753dc8969d4dda7..e7f8e9d9663900aac14764fdb154005578f157ba 100644 (file)
--- a/docs/en/get-started/establish-serial-connection.rst
+++ b/docs/en/get-started/establish-serial-connection.rst
@@ -54,6 +54,8 @@ MacOS ::
     ls /dev/cu.*
 
 
+.. note: MacOS users: if you don't see the serial port then check you have the USB/serial drivers installed as shown in the Getting Started guide for your particular development board. For MacOS High Sierra (10.13), you may also have to explicitly allow the drivers to load. Open System Preferences -> Security & Privacy -> General and check if there is a message shown here about "System Software from developer ..." where the developer name is Silicon Labs or FTDI.
+
 .. _linux-dialout-group:
 
 Adding user to ``dialout`` on Linux

diff --git a/docs/en/get-started/macos-setup.rst b/docs/en/get-started/macos-setup.rst
index a699c3bef6ba57eadce79bfc2915571599d9c583..70142482e82e706b0fd1ecadc72ecd9e2bfa84a7 100644 (file)
--- a/docs/en/get-started/macos-setup.rst
+++ b/docs/en/get-started/macos-setup.rst
@@ -8,6 +8,8 @@ Standard Setup of Toolchain for Mac OS
 Install Prerequisites
 =====================
 
+ESP-IDF will use the version of Python installed by default on Mac OS.
+
 - install pip::
 
     sudo easy_install pip