Merge pull request #182 from pycom/fix-pybytes-getting-started

Improve Pybytes getting started guide

Author: Jirka Krepl

content/pybytes/connect/README.md

@@ -6,34 +6,29 @@ aliases:
 
 In this section, we will explain to you how to add a device to Pybytes.
 
-## Step 1: Add device wizard
+## Step 1: Configure the Pybytes service
 
-In Pybytes, go to *Devices* Page:
+Go to the *Devices* page in Pybytes:
 
 1. Click on *Add Device*.
-
 ![](/gitbook/assets/pybytes/add-device/add-device-btn.png)
 
-2. Select your device (WiPy, LoPy, SiPy, etc.);
-
+1. Select your device (WiPy, LoPy, SiPy, etc.).
 ![](/gitbook/assets/pybytes/add-device/select-device-type.png)
 
-4. Select your network option;
-
+1. Select your network options. This will be how your device connects to both Pybytes and the internet. For now, choose WiFi.
 ![](/gitbook/assets/pybytes/add-device/network-step.png)
 
-5. Enter a unique name and the network credentials (SSID and password) for your device;
-
+1. Enter a unique name for your device and enter the WiFi credentials (SSID and password). You can save this WiFi, so that it will be remembered for later use when adding further devices.
 ![](/gitbook/assets/pybytes/add-device/customize-step.png)
 
-## Step 2: Connect your device to Pybytes
-
-At the end of the "Add Device" wizard, Pybytes will show that your device profile was successfully created.
-
+1. At the end of the *Add Device* wizard, Pybytes will show that your device profile was successfully created.
 ![](/gitbook/assets/pybytes/add-device/final-step.png)
 
-Select how you would like to connect your device to Pybytes:
+## Step 2: Configure your device
+
+There are two options for connecting your device to Pybytes:
 
-1. **[Connect your device quickly](quick) (Recommended)**
+1. **Recommended:** [Connect your device quickly with the help of the Firmware Updater](quick)
 
-2. [Connect your device by flashing Pybytes Library](flash) (only if you want to customize Pybytes library code).
+1. [Connect your device by flashing Pybytes Library](flash) (only if you want to customize Pybytes library code).

content/pybytes/connect/_index.md

@@ -8,51 +8,43 @@ aliases:
 
 In this section, we explain to you how to connect your device to Pybytes quickly using the Firmware Updater tool.
 
-### 1. Download Pycom Firmware updater tool
-
-![](/gitbook/assets/pybytes/add-device/final-step.png)
-
-From the last step of the "Add Device" process. Download and install Pycom Firmware updater tool from the provided link (Firmware updater is also available on [pycom.io](https://pycom.io/downloads/)).
+### Download Pycom Firmware Updater tool
 
+1. At the final step of the "Add Device" process, you can download and install the [Pycom Firmware Updater tool](https://pycom.io/downloads/)).
 ![](/gitbook/assets/pybytes/add-device/connect-your-device-component.png)
 
-Copy the activation token by pressing the copy button. The activation token is valid for one hour. If your activation token is expired, you can create a new one.
+1. Copy the activation token by pressing the Copy button. The activation token is valid for one hour. If your activation token has expired, you can create a new one.
+
 
-### 2. Flash Pybytes firmware with Pycom Firmware updater tool
+### Flash Pybytes firmware with Pycom Firmware Updater tool
 
 #### Before you start
 * Connect your device to the computer
 * If your device is already connected, make sure it is not connected to Pymakr
 
 #### Firmware update process
 
-Open the Pycom Firmware updater tool on your computer and click on the Continue button.
-
+1. Open the Pycom Firmware Updater tool on your computer and click on the Continue button.
 ![](/gitbook/assets/pybytes/add-device/fw-updater/intro-screen.png)
 
-Click again on the Continue button.
-
+1. Click again on the Continue button.
 ![](/gitbook/assets/pybytes/add-device/fw-updater/attention-screen.png)
 
 {{% hint style="info" %}}
 If your device is already connected to your computer, on MacOS serial port will be automatically filled for you.
-At this step, you can also click on Rescan ports button to update ports listed in the Firmware updater.
+At this step, you can also click on Rescan ports button to update ports listed in the Firmware Updater.
 {{% /hint %}}
 
-Check the options "Erase flash file system" and "Force update Pybytes registration";
-
+1. Check the options "Erase flash file system" and "Force update Pybytes registration";
 ![](/gitbook/assets/pybytes/add-device/fw-updater/settings-screen.png)
 
-Paste your activation token from Pybytes. Firmware updater should display **Registration successful!**
-
+1. Paste your activation token from Pybytes. Firmware Updater should display **Registration successful!**
 ![](/gitbook/assets/pybytes/add-device/fw-updater/activation-token-screen.png)
 
-Then press the Continue button. Your device will be flashed with the Pybytes firmware. This should take about a minute.
-
+1. Then press the Continue button. Your device will be flashed with the Pybytes firmware. This should take about a minute.
 ![](/gitbook/assets/pybytes/add-device/fw-updater/update-in-progress-screen.png)
 
-After the updating process is done. You will be welcomed with the final screen. Click on Done to close the Firmware updater.
-
+1. After the updating process is done, you will see the final screen. Click on Done to close the Firmware Updater.
 ![](/gitbook/assets/pybytes/add-device/fw-updater/success-screen.png)
 
 ## Next step: Set up your device's dashboard!