[PC-1023] Getting Started Tutorial review (#365)

* [PC-1023] Grammar fixes

Some grammar fixes in the tutorial.

* [PC-1023] Documentation Fix

FIxing some URLs

* Update content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/content.md

Co-authored-by: Pablo Marquínez Ferrándiz <[email protected]>

* Revert "Update content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/content.md"

This reverts commit 74800a2c819e3b170f84166e72158f80ec8a7b5a.

* [PC-1023] Adding information about IP address

Adding images and information about how to connect to the Portenta X8 webpage when the default IP on the tutorial is not working properly.

---------

Co-authored-by: Pablo Marquínez Ferrándiz <[email protected]>

Author: Jorgetrujilloroman

content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/adb-ifconfig.PNG

@@ -29,15 +29,31 @@ software:
 
 ## Connecting to the Board
 
-Once the Portenta X8 is plugged in via USB, you can open your browser and go to http://192.168.7.1 if you use Windows and Linux or http://192.168.8.1 on MacOS. It can take up to 15 seconds for the board to boot up and make the page available. This web page is hosted on the Portenta X8, from this dashboard you will be able to:
+Once the Portenta X8 is plugged in via USB, you can open your browser and go to http://192.168.7.1 if you use Windows and Linux or http://192.168.8.1 on MacOS. It can take up to 15 seconds for the board to boot up and make the page available. 
 
 ![Board set up page](assets/x8-oob-main.png)
 
+This web page is hosted on the Portenta X8, from this dashboard you will be able to:
+
 * [Configure Wi-Fi](#connecting-to-your-wi-fi)
 * [Add your device to FoundriesFactory (OTA)](#add-a-new-device-to-your-factory)
 * Board details
 * Shell (alpine Python®)
 
+***If those IP addresses do not work for you, you will need to follow the steps below:***
+
+First you will need to connect to your board via ADB as described in [this section](#adb) of the tutorial.
+
+Once you have connected to your board via ADB you should be able to run the next command: `ifconfig`. Among the list of interfaces that appears, look for "wlan0" as shown in the following image.
+
+![ADB ifconfig](assets/adb-ifconfig.PNG)
+
+Then copy the IP address next to "inet" and paste it into your web browser. You should be able to log in successfully this way.
+
+![Connecting through ip](assets/x8-ip-connect.PNG)
+
+Once you have successfully accessed this web page, you will be able to connect the board to your Wi-Fi network.
+
 ## Connecting to Your Wi-Fi
 
 Click the Wi-Fi button to start configuring your network connection.
@@ -46,7 +62,7 @@ Click the Wi-Fi button to start configuring your network connection.
 
 Select your Wi-Fi SSID.
 
-![Wi-Fi ssid set up](assets/x8-oob-wifi-ssid.png)
+![Wi-Fi SSID set up](assets/x8-oob-wifi-ssid.png)
 
 Type the password.
 
@@ -56,15 +72,15 @@ Once it is connected, you should see the Wi-Fi status bullet in the bottom left
 
 ![Wi-Fi connection done](assets/x8-oob-wifi-sucess.png)
 
-***You can change your network by clicking on the button again and repeat the above steps***
+***You can change your network by clicking on the button again and repeating the above steps***
 
 ## Connect to FoundriesFactory
 
 ### Register a FoundriesFactory on Foundries.io
 
-***The integration with Foundries.io requires the Arduino Pro Cloud Subscription, subscribe at [Arduino PRO Cloud for Business](https://cloud.arduino.cc/plans), or learn more on the [Arduino Pro Page](https://www.arduino.cc/pro/hardware/product/portenta-x8#pro-cloud)***
+***Integration with Foundries.io is not required to use your Portenta X8 Board, but if you are going to use it, it requires a subscription to the Arduino Pro Cloud; you can subscribe at [Arduino PRO Cloud for Business](https://cloud.arduino.cc/plans), or learn more on the [Arduino Pro Page](https://www.arduino.cc/pro/hardware-product-portenta-x8/)***
 
-Go to [https://create.arduino.cc](https://create.arduino.cc) and click on Portenta X8 Board Manager, you will get prompted to set a new `Factory` name if you did not have one before. You will not be able to be change the name later, so use one that you can remember and write easily.
+Go to [https://create.arduino.cc](https://create.arduino.cc) and click on Portenta X8 Board Manager, you will get prompted to set a new `Factory` name if you did not have one before. You will not be able to change the name later, so use one that you can remember and write easily.
 
 ![Arduino Cloud integration](assets/cloud-main.png)
 
@@ -76,7 +92,7 @@ Then you can go to [https://app.foundries.io/factories](https://app.foundries.io
 
 ![Foundries Factories](assets/foundries-factories.png)
 
-After you have created your FoundriesFactory you need to go back to the Portenta-X8 web dashboard to add a new device into your new Factory.
+After you have created your FoundriesFactory you need to go back to the Portenta-X8 web dashboard to add a new device to your new Factory.
 
 ### Add A New Device To Your Factory
 
@@ -100,7 +116,7 @@ Confirm the addition of the new device by pressing "Connect"
 
 ![Foundries device confirmation](assets/foundries-activation-prompt.png)
 
-Finally you will see a confirmation which means that your device now is attached to the new Factory.
+Finally, you will see a confirmation which means that your device now is attached to the new Factory.
 
 ![Dashboard with a Factory attached](assets/foundries-activation-success.png)
 
@@ -110,7 +126,7 @@ Once it is completed, the Factory button on the Portenta X8 dashboard will turn
 
 #### Check Your FoundriesFactory
 
-Have a look to your factories by going to [Foundries.io factories page](https://app.foundries.io/factories)
+Have a look at your factories by going to [Foundries.io factories page](https://app.foundries.io/factories)
 
 ![Foundries.io factories page](assets/foundries-factories.png)
 
@@ -130,11 +146,11 @@ Then choose the device you want to check by clicking on its box and it will open
 
 ## Controlling Portenta X8 Through the Terminal
 
-You have plenty of ways to communicate with your board, be it wirelessly or with a cable. Next we are going to show how to use adb and ssh.
+You have plenty of ways to communicate with your board, be it wirelessly or with a cable. Next, we are going to show how to use ADB and SSH.
 
 ### ADB
 
-First of all make sure you have the latest **Mbed OS Portenta Core**, which contains the adb program.
+First of all make sure you have the latest **Mbed OS Portenta Core**, which contains the ADB program.
 
 You can go to its directory inside the **Arduino15/packages/arduino/tools/adb/32.0.0**. To check the tool you can use your terminal and type `adb`, you should get feedback from the tool when typing this.
 
@@ -146,33 +162,33 @@ If you only see one device you can try and type `adb shell`, you are now communi
 
 ### SSH
 
-SSH is commonly used for remote control on different kinds of devices running different set ups through TCP-IP.
+SSH is commonly used for remote control on different kinds of devices running different setups through TCP-IP.
 
-To communicate with your board, you will need to know the IP of it, and just type `ssh fio@<IP>`, then the terminal workaround should be the same as ADB. The password is `fio`.
+To communicate with your board, you will need to know its IP, and just type `ssh fio@<IP>`, then the terminal workaround should be the same as ADB. The password is `fio`.
 
 ![SSH connection](assets/ssh-connection.png)
 
-As it is a linux device, you can do normal stuff like creating files, changing directory, etc.
+As it is a Linux device, you can do normal stuff like creating files, changing between directories, etc.
 
-To gain admin (root) access, type `sudo su -` and the password is `fio`  after that the terminal prefix should turn red.
+To gain admin (root) access, type `sudo su -` and the password is `fio` after that the terminal prefix should turn red.
 
 ![CLI configured](assets/ssh-connection-admin.png)
 
 ### CLI Commands
 
 ### Connect to a Wi-Fi Access Point
 
-Using the network manager tool `nmcli`:
+Using the network management tool `nmcli`:
 
-`nmcli device wifi connect <SSID> password <PASSWORD>`
+`nmcli device Wi-Fi connect <SSID> password <PASSWORD>`
 
 To check your manager connection status, use this command:
 
 `nmcli de`
 
 ### Register Device to the FoundriesFactory
 
-***The integration with Foundries.io requires the Arduino Pro Cloud Subscription, subscribe at [Arduino PRO Cloud for Business](https://cloud.arduino.cc/plans), or learn more on the [Arduino Pro Page](https://www.arduino.cc/pro/hardware/product/portenta-x8#pro-cloud)***
+***The integration with Foundries.io requires the Arduino Pro Cloud Subscription, subscribe at [Arduino PRO Cloud for Business](https://cloud.arduino.cc/plans), or learn more on the [Arduino Pro Page](https://www.arduino.cc/pro/hardware-product-portenta-x8/)***
 
 Make sure the name is not already being used in your Factory.
 
@@ -185,7 +201,7 @@ Make sure the name is not already being used in your Factory.
 `sudo systemctl stop fioconfig.service`
 `sudo rm /var/sota/sql.db`
 
-### Inspecting Real Time Tasks
+### Inspecting Real-Time Tasks
 
 Run: `journalctl -f` to see what's going on on the device