review micropython installation

Author: karlsoderby

content/micropython/03.micropython/00.first-steps/01.install-guide/installing-micropython.md

@@ -1,21 +1,22 @@
 ---
 featured: micropython-101
-title: '1. Introduction to Arduino'
-description: 'Learn about the Arduino platform'
-author: 'Karl Söderby'
+title: 'Installing MicroPython'
+description: 'Learn how to install MicroPython on your Arduino board.'
+author: 'Pedro Lima & Karl Söderby'
 hero_image: "./hero-banner.png"
 ---
 
 # Installing MicroPython
 
-In this article, we'll walk you through the process of installing MicroPython on your Arduino board. By the end of this guide, you (and your board) will be ready to write and run your first MicroPython script. Let's get started!
+In this article, we will go through the necessary tools needed to install and run MicroPython on an Arduino board. By the end of this guide, we will be ready to write and run our first MicroPython script. Let's get started!
 
 ## Requirements
 
-Before you begin, make sure you have the following:
+Before we start, let's check the requirements:
 
-### Supported Arduino Boards
-MicroPython is officially supported on several Arduino boards. Here’s a list of compatible boards:
+### MicroPython Compatible Arduino Boards
+
+MicroPython is officially supported on several Arduino boards. Here’s a list of the compatible boards:
 
 - [Portenta C33](https://store.arduino.cc/products/portenta-c33)
 - [Arduino GIGA R1 WiFi](https://store.arduino.cc/products/arduino-giga-r1-wifi)
@@ -35,50 +36,90 @@ MicroPython is officially supported on several Arduino boards. Here’s a list o
 
 
 ### Software Requirements
-- **Arduino Labs for Micropython**: Ensure you have the [latest version](https://labs.arduino.cc/en/labs/micropython) of the IDE. (Optional)
-- **MicroPython Firmware Installer**: [This installer](https://labs.arduino.cc/en/labs/micropython-installer) is needed to upload the MicroPython firmware onto your Arduino board. You can download it from the official Arduino website under the MicroPython section.
 
-## How to setup your board
+- [MicroPython Firmware Installer](https://labs.arduino.cc/en/labs/micropython-installer) - the firmware installer is needed to install MicroPython on our Arduino board. 
+- [Arduino Lab for Micropython](https://labs.arduino.cc/en/labs/micropython) - Arduino Lab for MicroPython is an editor where we can create and run MicroPython scripts on our Arduino board.
+
+***Note that the editor is also available online, at [Arduino Cloud - Arduino Labs for MicroPython](https://lab-micropython.arduino.cc/)
+
+## Install MicroPython
 
-1. If you haven’t already, download the [Micropython Firmware Installer](https://labs.arduino.cc/en/labs/micropython-installer) and launch it.
-2. Plug your board, it should be recognized by the installer.
-![Arduino Nano ESP32 detected!](./assets/board-selected.png)
+1. First, download the [Micropython Firmware Installer](https://labs.arduino.cc/en/labs/micropython-installer) and launch it.
+2. Connect your board to your computer, it should be recognized by the installer.
+    ![Arduino Nano ESP32 detected!](./assets/board-selected.png)
 3. Press **INSTALL MICROPYTHON**. A loading animation will appear.
 
-Once the firmware is installed a "Installation successful" message will appear. At this point you can safely close the installer as your board is now ready for tinkering!
-![Firmware Successfully Uploaded!](./assets/flashed.png)
+    Once the firmware is installed a "Installation successful" message will appear. At this point you can safely close the  installer as your board is now ready for tinkering!
+    ![Firmware Successfully Uploaded!](./assets/flashed.png)
+
+## Editor Setup
+
+After installing MicroPython on your board, we will need an editor to write code. We now have the option to choose the **offline** or **online** option.
+
+### Offline Setup
+
+First, download the latest version of [Arduino Lab for MicroPython](https://labs.arduino.cc/en/labs/micropython) for your operative system. See instructions for MacOS / Windows below:
+
+#### MacOS
+
+Run the downloaded file, and move it to your **"Applications"** folder.
+
+![Installation MacOS.]()
 
-### IDE setup
+#### Windows
 
-#### Offline IDE
+Unzip the downloaded file, and run the executeable file (`.exe`). 
 
-After downloading the [latest version](https://labs.arduino.cc/en/labs/micropython) of the IDE you can use it for the first time by:
-- Unpack the compressed folder you downloaded.
-- Execute "Arduino Lab for MicroPython.exe"
+![Installation Windows]()
 
-#### Online IDE
+### Online Setup
 
-Alternatively, you can use the IDE without installing it by using the online version available [here](https://lab-micropython.arduino.cc/).
+Alternatively, we can use the IDE without the need of installing anything. Simply visit the link below:
+- [Arduino Lab for MicroPython (online).](https://lab-micropython.arduino.cc/).
 
-#### Connecting Board and IDE
+## Connecting Board and IDE
 
-1. Plug your Arduino board into your computer using a USB cable.
-2. Press the connection button on the top left corner of the window. This will look like a plug and socket as in this image:
-TODO: ADD IMAGE OF CONNECTION
-3. Select the COM port where your board is connected.
+At this point in the tutorial, we have
+- Installed MicroPython on our board
+- Downloaded and installed the editor (or opted for the online version).
 
-You are now ready to upload your first sketch.
-TODO: A 4 step screenshot to explain the processimage
+We will now try out running a script on the board, to make sure things are working properly.
+
+1. Plug the Arduino board into the computer using a USB cable.
+    ![Connect board to computer.]()
+2. Press the connection button on the top left corner of the window.
+    ![Connect the editor to the board.]()
+3. The connected Arduino board should appear, and we can click it:
+    ![Select board.]()
+
+We have now set up all necessary steps for running a script!
+
+## Running a Test Script
+
+With the installation and setup complete, let's try out running a very simple script: **Hello World!**
+
+1. In the text area field of the editor, write the following: `print("Hello World!")`
+   ![Write hello world.]()
+2. Click on the play symbol (RUN).
+   ![Run the script.]()
+3. After running it, you should see `Hello World!` in the black box. This is the board sending the **"Hello World!"** back to you, because the script is run on the board, not on the computer. This means everything is successful, and you are ready to start writing MicroPython scripts! 
+   ![Hello world from the board.]()
 
 ## Troubleshooting
 
 If you run into any issues during installation, here are some common problems and solutions:
 
-### 1. **Board Not Detected**
-- **Solution**: Ensure that your board is properly connected and the correct USB drivers are installed. Try using a different USB cable or port.
+- **Board Not Detected** - if you cannot locate your board, ensure that your board is properly connected and the correct USB drivers are installed. Try using a different USB cable, or double tap the reset button on the board. If a light starts fading, it means it is in default mode, and is ready to be installed!
+
+- **Unable to Install Firmware** - double-check that the MicroPython Firmware Installer was able to install the firmware and that your board is compatible (it will not show up on the installer if it is not). Also, verify that no other software is using the same serial port.
+
+## Summary
+
+By following these steps, you should be able to successfully install MicroPython on your Arduino board and run your first script.
+
+### Next Steps
 
-### 2. **Unable to Flash Firmware**
-- **Solution**: Double-check that the MicroPython Firmware Installer was able to burn the firmware and that your board is compatible(it will not show up on the installer if it is not). Also, verify that no other software is using the serial port.
+This tutorial is **Part Two** of the **"First Steps"** series. We recommend you following the next tutorial that will allow you to control the Arduino board's LED.
+- [First Steps - Part Three]()
+ 
 
-By following these steps, you should be able to successfully install MicroPython on your Arduino board and run your first script. Stay tuned for more tutorials to help you get the most out of MicroPython!
-For information on how to uploadyour first sketch please check [](). TODO: We need to add here the guide for first sketch once it is linkable