diff --git a/docs/platforms/espressif_extra.rst b/docs/platforms/espressif_extra.rst
index ae92131d..8443c4f7 100644
--- a/docs/platforms/espressif_extra.rst
+++ b/docs/platforms/espressif_extra.rst
@@ -62,12 +62,13 @@ Uploading files to file system SPIFFS
     Please make sure to read `ESP8266 Flash layout <https://github.com/esp8266/Arduino/blob/master/doc/filesystem.md#flash-layout>`_
     information first.
 
-1. Create :ref:`projectconf_pio_data_dir` and put files here
-2. Run target ``uploadfs`` via  :option:`platformio run --target` command.
+1. Initialise project :ref:`cmd_init` (if you have not initialized yet)
+2. Create :ref:`projectconf_pio_data_dir` and put files here
+3. Run target ``uploadfs`` using  :option:`platformio run --target` command.
 
 To upload SPIFFS image using OTA update please specify ``upload_port`` /
-``--upload-port`` as IP address or DNS name (``*.local``). For the details
-please follow to :ref:`platform_espressif_ota`.
+``--upload-port`` as IP address or mDNS host name (ending with the ``*.local``).
+For the details please follow to :ref:`platform_espressif_ota`.
 
 By default, will be used default LD Script for the board where is specified
 SPIFFS offsets (start, end, page, block). You can override it using