diff --git a/docs/en/get-started/establish-serial-connection.rst b/docs/en/get-started/establish-serial-connection.rst
index 363de1cce..e7f8e9d96 100644
--- 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 a699c3bef..70142482e 100644
--- 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