[IMP] IoT: edits to all IoT docs

closes odoo/documentation#4927

X-original-commit: e7457c992b
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>

content/applications/productivity/iot/config/flash_sdcard.rst

@@ -1,37 +1,68 @@
-=====================
-Flashing your SD Card
-=====================
+====================
+Flashing the SD card
+====================
 
-In some case, you may need to reflash your IoT Box’s SD Card to benefit
-from our latest updates.
+In some circumstances, the :abbr:`IoT (Internet of Things)` box's micro SD Card may need to be
+re-flashed to benefit from Odoo's latest :abbr:`IoT (Internet of Things)` image update. This means
+that the Odoo :abbr:`IoT (Internet of Things)` box software may need to be updated.
 
-Upgrade from the IoT Box homepage
-=================================
+Upgrade from the IoT box home page
+==================================
 
-Go to the IoT Box homepage, click on *Update*, next to the version number.
-If a new version of the IoT Box image is available, you will see a
-*Upgrade to ___* button a the bottom of the page, the IoT Box will then
-flash itself to the new version of the IoT Box. All of your configurations
-will be saved.
+Go to the :abbr:`IoT (Internet of Things)` box homepage by navigating to :menuselection:`IoT app -->
+IoT Boxes` and clicking on the :guilabel:`IP address` of the :abbr:`IoT (Internet of Things)` box.
+Then click on :guilabel:`Update` (next to the version number).
+
+If a new version of the :abbr:`IoT (Internet of Things)` Box image is available, an
+:guilabel:`Upgrade to _xx.xx_` button will appear at the bottom of the page. Click this button to
+upgrade the unit and the :abbr:`IoT (Internet of Things)` box will then flash itself to the new
+version. All of the previous configurations will be saved.
 
 .. note::
-   This process can take more than 30 minutes. Do not turn off or unplug
-   the IoT Box as it would leave it in an inconsistent state.
+   This process can take more than 30 minutes. Do not turn off or unplug the :abbr:`IoT (Internet of
+   Things)` box as it would leave it in an inconsistent state. This means that the :abbr:`IoT
+   (Internet of Things)` box will need to be re-flashed with a new image. See
+   :ref:`flash_sdcard/etcher`.
 
-.. image:: flash_sdcard/flash_sdcard01.png
+.. image:: flash_sdcard/flash-upgrade.png
    :align: center
+   :alt: IoT box software upgrade in the IoT Box Home Page.
 
-Upgrade with Etcher
-===================
+.. _flash_sdcard/etcher:
 
-Go to Balena’s website and download `Etcher <https://www.balena.io/>`__.
-It’s a free and open-source utility used for burning image files.
-Install and launch it. Download the latest image from `nightly
-<http://nightly.odoo.com/master/iotbox/>`__.
+Upgrade with Etcher Software
+============================
 
-Then, open *Etcher* and select *Flash from file*, find the image you just
-downloaded. Insert the IoT Box SD card into your computer and select it.
-Click on *Flash* and wait for the process to finish.
+.. note::
+   A computer with a micro SD card reader/adapter is required in order to re-flash the micro SD
+   card.
 
-.. image:: flash_sdcard/flash_sdcard02.png
+Navigate to Balena's website and download `Etcher <https://www.balena.io/>`_. It's a free and
+open-source utility used for burning image files onto drives. Click to `download
+<https://www.balena.io/etcher#download-etcher>`_. Install and launch the program on the computer.
+
+Then download the version-specific :abbr:`IoT (Internet of Things)` image from `nightly
+<http://nightly.odoo.com/master/iotbox/>`_.
+
+The following are image versions on the `nightly <http://nightly.odoo.com/master/iotbox/>`_ website
+with their corresponding Odoo database version:
+
+- Odoo V16 --> iotbox-latest.zip
+- Odoo V15 --> iotboxv21_10.zip
+- Odoo V14 --> iotboxv21_04.zip
+- Odoo V13 --> iotboxv20_10.zip
+
+The images should be downloaded and extracted to a convenient file location.
+
+After this step is complete, insert the :abbr:`IoT (Internet of Things)` box's micro SD card into
+the computer or reader. Open *Etcher* and select :guilabel:`Flash from file`, then find and select
+the image just downloaded and extracted. Next, select the drive the image should be burned to.
+Lastly, click on :guilabel:`Flash` and wait for the process to finish.
+
+.. image:: flash_sdcard/etcher-app.png
    :align: center
+   :alt: Balena's Etcher software dashboard.
+
+.. note::
+   An alternative software for flashing the micro SD card is *Raspberry Pi Imager*. Download the
+   *Raspberry Pi* software `here <https://www.raspberrypi.com/software/>`_.