Tutorials 4 5 Update

Author: TaddyHC

content/hardware/04.pro/boards/portenta-x8/tutorials/04.python-arduino-data-exchange/content.md

@@ -12,11 +12,11 @@ hardware:
 
 ## Overview
 
-The container infrastructure provided by Arduino contains a pre-built Python® image that you can use to run Python® applications on the Portenta X8. In this tutorial, we're going to build a container based on a provided one.
+The container infrastructure provided by Arduino contains a pre-built Python® image that you can use to run Python® applications on the Portenta X8. In this tutorial, we are going to build a container based on a provided one.
 
 While all the peripherals are accessible from the iMX8 processor running the Linux environment, it can be useful to let the onboard microcontroller take care of certain peripheral handling and exchange only the required data between the microcontroller and the Python® application.
 
-Thus you will learn how to do that. If you haven't done so, read through the [user manual](https://docs.arduino.cc/tutorials/portenta-x8/user-manual) to understand the fundamental concepts of the X8 and the provided infrastructure.
+You will be guided on how to achieve this setup. It is recommendable to familiarize yourself with the foundational elements of the Portenta X8 and its infrastructure by reading the [user manual](https://docs.arduino.cc/tutorials/portenta-x8/user-manual) if you have not already done so.
 
 ## Goals
 
@@ -27,9 +27,9 @@ Thus you will learn how to do that. If you haven't done so, read through the [us
 
 ### Required Hardware and Software
 
-- [Portenta X8](https://store.arduino.cc/products/portenta-x8) board
-- [Portenta breakout](https://docs.arduino.cc/hardware/portenta-breakout) board
-- Any sensor (in this example, we'll use an [BME680](https://www.bosch-sensortec.com/products/environmental-sensors/gas-sensors/bme680/) I<sup>2</sup>C module)
+- [Portenta X8](https://store.arduino.cc/products/portenta-x8)
+- [Portenta breakout](https://docs.arduino.cc/hardware/portenta-breakout)
+- Any sensor (in this example, we will use an [BME680](https://www.bosch-sensortec.com/products/environmental-sensors/gas-sensors/bme680/) I<sup>2</sup>C module)
 - [Arduino IDE 1.8.10+](https://www.arduino.cc/en/software), [Arduino IDE 2](https://www.arduino.cc/en/software), or [Arduino Web Editor](https://create.arduino.cc/editor)
 
 ## Python® on the X8
@@ -93,7 +93,7 @@ Make sure you have installed the **Arduino Mbed OS Portenta Boards** core and up
 
 To check if the Arduino sketch is working correctly, you may want to read the messages from the `Serial.println` statements. You cannot currently read them directly in the serial monitor of the Arduino IDE. Instead, you can use a simple service called **`py-serialrpc`**, which listens for those messages and prints them to the console.
 
-This service needs to run on the Linux side of the X8. You can get the files [here](assets/py-serialrpc.zip). From the command prompt of your local machine, navigate to the adb tool folder and upload the files to the X8 with command:
+This service needs to run on the Linux side of the X8. You can get the files [here](assets/py-serialrpc.zip). The compressed file will have every file needed to build a container as the docker compose app. From the command prompt of your local machine, navigate to the adb tool folder and upload the files to the X8 with command:
 
 ```bash
 adb push <local directory path>/py-serialrpc /home/fio
@@ -199,15 +199,19 @@ sudo docker build . -t python-sensor-rpc
 sudo docker compose up
 ```
 
-Alternatively, you could modify the files directly on the X8 using an editor such as *VIM*, so you do not need to upload the files every time. Rebuilding the container will be necessary in any case though.
+Alternatively, you could modify the files directly on the X8 using an editor such as **VIM**, so you do not need to upload the files every time. Rebuilding the container will be necessary in any case though.
 
-If you wonder how to specify the Python® script that is executed when running a container, have a look at the `Dockerfile` file. There you will find the `ENTRYPOINT` command that takes multiple arguments. In our example: `ENTRYPOINT [ "python3", "m4_to_python.py"]`.
+If you wonder how to specify the Python® script that is executed when running a container, have a look at the `Dockerfile` file. There you will find the `ENTRYPOINT` command that takes multiple arguments. In our example:
+
+```python
+ENTRYPOINT [ "python3", "m4_to_python.py"]`
+```
 
 ## Conclusion
 
 In this tutorial, you learned how to use the docker infrastructure to build a container that runs a Python® application. You have also learned how to use the RPC mechanism to exchange data between the microcontroller and the iMX8, which runs the Linux operating system.
 
 ### Next Steps
 
-- You may now further process the data that you receive from the Arduino sketch and e.g. upload it to a Cloud service or similar.
+- You may further process the data you receive from the Arduino sketch and, e.g., upload it to a Cloud service or similar.
 - Familiarize yourself with Docker commands to adjust the docker configuration to your needs.

content/hardware/04.pro/boards/portenta-x8/tutorials/05.docker-container/content.md

@@ -16,11 +16,11 @@ hardware:
 
 ## Overview
 
-[Docker](http://docker.com) is a platform full of applications, called containers. Containers are isolated solutions, thus they don't have to depend on your environment. Making them portable and consistent throughout development, testing, and production.
+[Docker](http://docker.com) is a platform full of applications called containers. Containers are isolated solutions; thus, they do not have to depend on your environment, making them portable and consistent throughout development, testing, and production.
 
 You can download, install, use, and share applications in the form of containers. You can find all the available container images on the [hub.docker.com](https://hub.docker.com) page.
 
-In this tutorial, we will go through the steps of how to install, run and remove Docker's official [Hello-World image](https://hub.docker.com/_/hello-world)
+In this tutorial, we will go through the steps of how to install, run, and remove Docker's official [Hello-World image](https://hub.docker.com/_/hello-world).
 
 ## Goals
 
@@ -31,7 +31,7 @@ In this tutorial, we will go through the steps of how to install, run and remove
 
 ### Hardware and Software Requirements
 
-- [Arduino® Portenta X8](https://store.arduino.cc/products/portenta-x8)
+- [Portenta X8](https://store.arduino.cc/products/portenta-x8)
 - USB-C® cable (either USB-C® to USB-A or USB-C® to USB-C®)
 - Wi-Fi® Access Point with Internet Access
 - ADB: [Check how to connect to your Portenta X8](https://docs.arduino.cc/tutorials/portenta-x8/user-manual#out-of-the-box-experience)
@@ -41,17 +41,23 @@ In this tutorial, we will go through the steps of how to install, run and remove
 
 ## Using Docker
 
-The Portenta X8 provides Docker CLI by default. The following command will help you verify if it is installed correctly:
+The Portenta X8 provides Docker CLI by default. To verify its correct installation, use the following command:
 
 ```bash
 docker -v
 ```
 
+Or as well:
+
+```bash
+docker --version
+```
+
 ***To use this tool, you will need to connect to your device first. Check [how to connect using adb/ssh](https://docs.arduino.cc/tutorials/portenta-x8/user-manual#out-of-the-box-experience).***
 
-You can check Docker's reference documentation, which covers all the features of the tool in depth at [docs.docker.com](https://docs.docker.com/).
+You can explore Docker's comprehensive reference documentation, covering all tool features in depth, at [docs.docker.com](https://docs.docker.com/).
 
-The following steps will show how to install, run and uninstall the "Hello World" container.
+The following steps will show how to pull the **"Hello World"** image from Docker Hub, run the container, and view its status.
 
 To avoid a lack of permissions while launching ```adb shell```, you may type the following: ```newgrp - docker```.
 
@@ -61,7 +67,7 @@ The previous command and other important info about Linux on your Portenta are d
 
 First, you will need to search for ["Hello World" container image](https://hub.docker.com/_/hello-world). The container image can be found within the Docker hub, where you will be able to find a variety of readily-available container images. It will be used to verify docker is working as intended with the Portenta X8.
 
-The following command must be used to pull the `hello-world` image. The Docker hub page for images has the instructions to pull the image and deploy the container.
+The following command is used to pull the `hello-world` image. The Docker hub page for images has the instructions to pull the image and deploy the container.
 
 ```bash
 docker pull hello-world
@@ -71,17 +77,17 @@ docker pull hello-world
 
 ### Run The Installed Container
 
-This is the command to begin the container instance.
+Use this command to begin a container from the `hello-world` image:
 
 ```bash
 docker run hello-world
 ```
 
 ![Docker CLI running Hello World app](assets/docker-run.png)
 
-***To be able to see an active container with `docker ps -a`, you will need to run it at least once with `docker run`***
+***To see a list of active and exited containers, `docker ps -a` should be used after running a container at least once with `docker run`***
 
-### Listing The Installed Packages
+### Listing Active Containers And Available Docker Images
 
 The following command will display the active containers and will show the `hello-world` container if it was able to run successfully. The `STATUS` message will let you know if the container is active or has finished operation depending on its purpose.
 
@@ -99,17 +105,25 @@ docker images
 
 ![Docker CLI images](assets/docker-images.png)
 
-### How to Uninstall A Container
+### How to Remove A Container
+
+You will need to obtain an assigned `CONTAINER ID` to remove a container of your choice. This can be found by listing all containers, including inactive ones:
 
-You will need to obtain an assigned `CONTAINER ID` to be able to remove a container of your choice. The list of active containers provides this information. The remove (`rm`) command is then used with the desired container identifier to proceed with the removal process.
+```bash
+docker ps -a
+```
+
+The remove (`rm`) command is then used with the desired container identifier to proceed with the removal process.
 
 ```bash
 docker container rm <CONTAINER ID>
 ```
 
-For this example, the command `docker ps -a` will show the `CONTAINER ID` of the `hello-world` container designated as: `c44ba77b65cb`. If you encounter an error stating that the container cannot be removed, it may mean that the container has an actively ongoing operation which can be checked with `STATUS` message.
+For this example, the command `docker ps -a` will show the `CONTAINER ID` of the `hello-world` container designated as: **`c44ba77b65cb`**.
+
+If you encounter an error stating that the container cannot be removed, it may mean that the container has an ongoing operation that can be checked with a `STATUS` message.
 
-Granted that this is the case, you will need to stop the container and verify with `STATUS` message that it has exited successfully. To do this, the following command is used:
+If this is the case, you will need to stop the container and verify with a `STATUS` message that it has exited successfully. To do this, the following command is used:
 
 ```bash
 docker stop <CONTAINER ID>