Merge pull request #115 from arduino/benjamindannegard/x8-gs-improvements

Benjamindannegard/x8 gs improvements

Author: BenjaminDannegard

content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/command-journalctl.png

@@ -20,7 +20,7 @@ software:
 
 ## Connecting to the Board
 
-Once the Portenta X8 its plugged via USB, you can open your browser and go to http://192.168.7.1 and see a web which is hosted by the board, 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 and see a web page which is hosted by the board, from this dashboard you will be able to:
 
 ![Board set up page](assets/x8-oob-main.png)
 
@@ -36,19 +36,20 @@ Click the Wi-Fi button to start configuring your network connection.
 
 ![Select wifi on set up page](assets/x8-oob-main-wifi.png)
 
-Select your Wi-Fi SSID
+Select your Wi-Fi SSID.
 
 ![Wifi ssid set up](assets/x8-oob-wifi-ssid.png)
 
-Type the password
+Type the password.
+
 ![Wifi password set up](assets/x8-oob-wifi-pass.png)
 
-Once its connected you should see the Wi-Fi status button on green.
+Once its connected you should see the Wi-Fi status dot in the bottom left turn green.
 
 ![Wifi connection done](assets/x8-oob-wifi-sucess.png)
 
 
-***You can change your network by clicking again on the button and repeat the steps***
+***You can change your network by clicking on the button again and repeat the steps***
 
 ## Registering a Factory
 
@@ -60,35 +61,33 @@ And set your new factory name.
 
 ![Name your factory](assets/x8-oob-factory-name.png)
 
-Click register, now you will get a code that you need to paste into your factory page by opening [Arduino Create Cloud](https://create.arduino.cc) in your browser and click inside the integrations section "Portenta X8 Board Manager"
+Click register, now you will get a code that you need to paste into your factory page by opening [Arduino Create Cloud](https://create.arduino.cc) in your browser and click the "Portenta X8 Board Manager" inside the integrations section.
 ![Complete factory page](assets/x8-oob-factory-register.png)
 ![Arduin Cloud integration](assets/cloud-main.png)
 
-Once it succeed the factory button will turn to green.
+Once it is completed the factory button will turn green.
 
 ![Successful connection](assets/x8-oob-wifi-sucess.png)
 
 
 ## Controlling Portenta X8 Through the Terminal
 
-You have plenty of ways to communicate with your board, we are going to show 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 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 type on your terminal `adb` you should get feedback from the tool.
+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 teminal and type `adb`, you should get feedback from the tool when typing this.
 
 To know the list of devices that can be accessed type `adb devices`.
 
-If you see only one you just can type `adb shell` if it succeed, you are now communicating to your Portenta X8.
+If you only see one device you can try and type `adb shell`, you are now communicating with your Portenta X8.
 
 ### SSH
 
-SSH is commonly used for remote control on a different kind of devices running different set ups 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.  
+SSH is commonly used for remote control on different kinds of devices running different set ups through TCP-IP.
 
-The password is `fio`.
+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`.
 
 ![SSH connection](assets/ssh-connection.png)
 As it is a linux device, you can do normal stuff like creating files, changing directory, etc.
@@ -111,4 +110,4 @@ Make sure you have the latest mbed Core and as every other board you can select
 
 And click compile and upload.
 
-***Make sure you don't share GPIOs on the linux side and the Arduino sketc, this will avoid possible errors***
+***Make sure you don't share GPIOs on the linux side and the Arduino sketch, this will avoid possible errors***