Merge pull request #663 from arduino/karlsoderby/python-update

Python Guide Updates

Author: karlsoderby

content/learn/03.programming/05.arduino-and-python/arduino-and-python.md

@@ -1,18 +1,21 @@
 ---
 author: 'Karl Söderby'
-title: 'Python with Arduino Boards'
-description: 'Learn about compatibility between the popular Python language and Arduino boards, how to set up your environment, and discover in-depth tutorials and useful links.'
+title: 'MicroPython with Arduino Boards'
+description: 'Learn about compatibility between the popular MicroPython implementation and Arduino boards, how to set up your environment, and discover in-depth tutorials and useful links.'
 tags: 
-  - Python
+  - MicroPython
+  - Arduino Lab
   - OpenMV
 hero_position: 1
 ---
 
-## Overview
+***To download the firmware required to run MicroPython on your Arduino board, visit the [Arduino MicroPython downloads page](/micropython).***
 
-[MicroPython](https://micropython.org/) is an implementation of the [Python programming language](https://www.python.org/) that comes with a subset of the Python standard library, and is designed **to run on microcontrollers**. A great advantage of using MicroPython is that it is easy to learn and has [great documentation](http://docs.micropython.org/en/latest/) for a number of boards. At the moment, there are four boards that can be used together with MicroPython, you can read more about them in the [compatible boards section](#compatible-boards).
+[MicroPython](https://micropython.org/) is an implementation of the [Python programming language](https://www.python.org/) that comes with a subset of the Python standard library, and is designed **to run on microcontrollers**. 
 
-Arduino officially supports [OpenMV's branch of MicroPython](https://github.com/openmv/micropython), and through the [OpenMV IDE](https://openmv.io/pages/download) you can install MicroPython, connect/disconnect your board and upload your scripts 
+A great advantage of using MicroPython is that it is easy to learn and has [great documentation](http://docs.micropython.org/en/latest/) for a number of boards. At the moment, there are four boards that can be used together with MicroPython, you can read more about them in the [compatible boards section](#compatible-boards).
+
+Arduino also supports [OpenMV's branch of MicroPython](https://github.com/openmv/micropython), and through the [OpenMV IDE](https://openmv.io/pages/download) you can install MicroPython, connect/disconnect your board and upload your scripts.
 
 ![Arduino boards officially supporting MicroPython.](assets/micropython-supported-boards.png)
 
@@ -37,11 +40,22 @@ As MicroPython is already running on the board, we don't need to compile and upl
 
 ***When installing MicroPython on a board, it can only run MicroPython scripts, until we "uninstall" it. To put the board back in "normal mode" we need to reset the bootloader, which is a unique process for each board. These instructions are available in the [compatible boards](#micropython-compatible-boards) section in this article. Basically, you have to put the board in bootloader mode and upload any .ino sketch. ***
 
+## Arduino Lab for MicroPython
+
+![Arduino Lab for MicroPython Editor](assets/mpylabs-ss.png)
+
+The [Arduino Lab for MicroPython](https://labs.arduino.cc/en/labs/micropython) is a lightweight editor designed for simple interaction between your computer and board. With it, you can select your port, load scripts, and use the REPL shell and more. 
+
+- [Download Arduino Lab for MicroPython Editor](https://labs.arduino.cc/en/labs/micropython).
+- [MicroPython Firmware downloads page](/micropython).
+
 ## OpenMV Editor
 
-The Arduino IDE does not yet support Python. Instead, we can use [OpenMV](https://openmv.io/), a platform that supports programming Arduino boards with MicroPython. Through the OpenMV editor, we can install MicroPython, and upload scripts directly to the board. There's also a number of examples available directly in the editor. 
+[OpenMV](https://openmv.io/) is a platform that supports programming Arduino boards using a fork of MicroPython. Through the OpenMV editor, we can install this fork, and upload scripts directly to the board. There's also a number of examples available directly in the editor. 
 
-![The OpenMV editor.](assets/placeholder-openmv.png)
+OpenMV is a great platform for computer vision and machine learning projects.
+
+![The OpenMV editor.](assets/openmv-ss.png)
 
 ### OpenMV Examples
 
@@ -64,9 +78,10 @@ All of above are also compatible with the **OpenMV IDE.**
 
 ![The Nano 33 BLE](assets/hero-nano-ble.png)
 
-If you need help getting started with MicroPython on the **Nano 33 BLE** board, you can check out the tutorial below:
+If you need help getting started with MicroPython on the **Nano 33 BLE** board, you can check out the tutorials below:
 
-- [Getting started with MicroPython with Nano 33 BLE](/tutorials/nano-33-ble/getting-started-omv) (setting up your environment).
+- [Install MicroPython on your Nano BLE](/tutorials/nano-33-ble-sense/micropython-installation#arduino-nano-33-ble).
+- [Getting started with OpenMV and Nano 33 BLE](/tutorials/nano-33-ble/getting-started-omv) 
 - [Nano 33 BLE Python API guide](/tutorials/nano-33-ble/ble-python-api) (a collection of useful scripts).
 
 ***To reset the bootloader on the Nano 33 BLE board, double tap the reset button quickly. This will reset your board to factory setting.***
@@ -77,7 +92,8 @@ If you need help getting started with MicroPython on the **Nano 33 BLE** board,
 
 If you need help getting started with MicroPython on the **Nano 33 BLE Sense** board, you can check out the tutorials below: 
 
-- [Getting started with MicroPython with Nano 33 BLE Sense](/tutorials/nano-33-ble-sense/getting-started-omv) (setting up your environment).
+- [Install MicroPython on your Nano BLE Sense](/tutorials/nano-33-ble-sense/micropython-installation#arduino-nano-33-ble).
+- [Getting started with OpenMV and Nano 33 BLE Sense](/tutorials/nano-33-ble-sense/getting-started-omv)
 - [Nano 33 BLE Sense Python guide](/tutorials/nano-33-ble-sense/ble-sense-python-api) (a collection of useful scripts).
 
 ***To reset the bootloader on the Nano 33 BLE Sense board, double tap the reset button quickly. This will reset your board to factory setting.***
@@ -88,8 +104,10 @@ If you need help getting started with MicroPython on the **Nano 33 BLE Sense** b
 
 If you need help getting started with MicroPython on the **Nano RP2040 Connect** board, you can check out the tutorials below:
 
-- [Getting Started with OpenMV and MicroPython on Nano RP2040 Connect](/tutorials/nano-rp2040-connect/rp2040-openmv-setup)
+- [Install MicroPython on your Nano RP2040 Connect](/tutorials/nano-rp2040-connect/micropython-installation#arduino-nano-rp2040-connect) 
 - [Nano RP2040 Connect Python guide](/tutorials/nano-rp2040-connect/rp2040-python-api)
+- [Getting Started with OpenMV and MicroPython on Nano RP2040 Connect](/tutorials/nano-rp2040-connect/rp2040-openmv-setup)
+
 
 ***To reset the bootloader, you will need to short to connect a jumper wire between the REC and GND pin, and press the reset button. More detailed instructions are available in the [Nano RP2040 Connect technical reference](/tutorials/nano-rp2040-connect/rp2040-01-technical-reference#board-not-detected).***
 
@@ -99,6 +117,7 @@ If you need help getting started with MicroPython on the **Nano RP2040 Connect**
 
 If you need help getting started with  MicroPython on the **Portenta H7** board, you can check out the tutorial below:
 
+- [Install MicroPython on Portenta H7](/tutorials/portenta-h7/micropython-installation#arduino-portenta-h7).
 - [Getting Started with OpenMV and MicroPython on Portenta H7](https://docs.arduino.cc/tutorials/portenta-h7/por-openmv-gs)
 
 ## Learn Python
@@ -122,7 +141,7 @@ This means it's time to learn the **Python** language, which there is a lot of r
 
 Visit the [MicroPython documentation](https://docs.micropython.org/en/latest/) for an understanding on how Python runs on microcontrollers.
 
-***Note that many examples will not work directly with Arduino boards, but will provide an understanding of how Python can run on a microcontroller.***
+***Note that many examples in the MicroPython Docs will not work directly with Arduino boards, but will provide an understanding of how Python can run on your board.***
 
 ## API
 
@@ -166,7 +185,7 @@ while True:
     time.sleep(1)
 ```
 
-### For loop
+### For Loop
 
 Simple use of a for loop and functions. This script counts to 10, and then back to 0.