diff --git a/docs/supported_ports.rst b/docs/supported_ports.rst
index 09571afb67..e74067e28f 100644
--- a/docs/supported_ports.rst
+++ b/docs/supported_ports.rst
@@ -17,3 +17,4 @@ is limited.
     ../ports/mimxrt10xx/README
     ../ports/nrf/README
     ../ports/stm/README
+    ../ports/esp32s2/README
diff --git a/ports/esp32s2/README.md b/ports/esp32s2/README.md
index 86aa99a13a..5b664df08c 100644
--- a/ports/esp32s2/README.md
+++ b/ports/esp32s2/README.md
@@ -42,13 +42,7 @@ Additionally, any time you open a new bash environment for building or flashing,
 . esp-idf/export.sh
 ```
 
-To build for a board such as the Saola 1 Wrover and flash it over the UART interface, run the following:
-
-```
-make BOARD=espressif_saola_1_wrover flash
-```
-
-On MacOS, you may need to directly specify the port. You can determine the correct port on your machine by running `ls /dev/tty.usb*` and selecting the one that appears only when your development board is plugged in. Example:
+Building boards such as the Saola is typically done through `make flash`. The default port is `tty.SLAB_USBtoUART`, which will only work on certain Mac setups. On most machines, both Mac and Linux, you will need to set the port yourself by running `ls /dev/tty.usb*` and selecting the one that only appears when your development board is plugged in. An example make command with the port setting is as follows:
 
 ```
 make BOARD=espressif_saola_1_wrover flash PORT=/dev/tty.usbserial-1421120