Merge pull request #567 from arduino/jacobhylen/cloud-docs-changes

Cloudv2 Guides docs review

Author: karlsoderby

content/arduino-cloud/01.guides/00.overview/overview.md

@@ -5,7 +5,7 @@ tags: [Arduino Cloud, Getting Started]
 author: 'Karl Söderby'
 ---
 
-The [Arduino Cloud](app.arduino.cc) is a platform for developing Arduino projects and connecting them to the world. It supports secure connections with boards via [Wi-Fi®](/arduino-cloud/hardware/wifi), [LoRa®](/arduino-cloud/hardware/lora), [Ethernet](/arduino-cloud/hardware/ethernet) and [Cellular (GSM/NB-IoT)](/arduino-cloud/hardware/cellular).
+The [Arduino Cloud](app.arduino.cc) is a platform for developing Arduino projects and connecting them to the world. It supports secure connections with boards via [Wi-Fi®](/arduino-cloud/hardware/wifi), [LoRa®](/arduino-cloud/hardware/lora), [Ethernet](/arduino-cloud/hardware/ethernet) and [Cellular (GSM/NB-IoT)](/arduino-cloud/hardware/cellular), and lets you create a system for sending any variable information you can think of from one board to another within minutes of unboxing them.
 
 The Arduino Cloud platform includes:
 - an **Integrated Development Environment (IDE)** for programming your boards,
@@ -16,7 +16,11 @@ The Arduino Cloud platform includes:
 Very simply explained, with the Arduino Cloud you can:
 1. Create a program for an Arduino based on a brilliant idea you just hatched.
 2. Upload the program to your board and synchronize any data you want to (most commonly through Wi-Fi®).
-3. Create a dashboard with a set of widgets to control and monitor your board. 
+3. Create a dashboard with a set of widgets to control and monitor your data.
+
+Developing a sketch made for the Arduino Cloud is almost just like developing any other sketch. You have your setup, and loop just like normal. But you are also able to select variables to be automatically synced to the Arduino Cloud. 
+
+Once a variable is synced to the Arduino Cloud you can access it from any of your other devices connected to the Arduino Cloud.  
 
 Once you have setup your project, this is how you could interact & monitor it. 
 
@@ -64,7 +68,7 @@ Anything in the Arduino Cloud can be accessed via the left action bar. In the li
 - **Templates** - templates are ready-made project that will automatically configure your device, Thing, 
 - **Integrations** - third party services that are integrated with the Arduino Cloud.
 
-## Get Started with Arduino Cloud
+## A Walkthrough the Arduino Cloud
 
 Setting up a project in the Arduino Cloud is easy, and can be done through a few simple steps summarized in this section.
 
@@ -78,7 +82,7 @@ By default, you will have a **free plan**, which can be upgraded to a number of
 
 ### 2. Configure a Device
 
-First you will need to connect your board to your computer, and configure your device at [app.arduino.cc/devices](app.arduino.cc/devices).
+First you will need to connect your board to your computer, and configure your device in the [Devices](app.arduino.cc/devices) tab.
 
 ![Devices in the Arduino Cloud.](assets/device.png)
 
@@ -94,7 +98,7 @@ After configuring a device, we can create a Thing, which is the **virtual twin**
 
 Variables we create will be used in the sketch, and will keep synchronizing as long as the board is connected to the cloud. 
 
-When working with your IoT projects, consider this the "main space" for configurations, as you can access your sketche from here as well. 
+When working with your IoT projects, consider this the "main space" for configurations, as you can access your sketches from here as well. 
 
 ***Learn more in the documentation for [Arduino Cloud Things](/arduino-cloud/cloud-interface/things).***
 

content/arduino-cloud/01.guides/01.cloud-editor/getting-started-cloud-editor.md

@@ -5,13 +5,13 @@ author: 'Karl Söderby'
 ---
 
 
-The Cloud Editor is a great choice for working with your Arduino board. It stores all of your sketches online, requires no installation of cores and includes most of the popular libraries.
+The Cloud Editor is a great choice for working with your Arduino board. It stores all of your sketches online, doesn't require you to install board packages and includes most of the popular libraries, while letting you upload your own if you need to.
 
-Getting started with the Web Editor is quick & easy, and in this tutorial, we will walk you through the necessary steps so you can use it with your Arduino board.
+Getting started with the Cloud Editor is quick & easy, and in this tutorial, we will walk you through the necessary steps so you can use it with your Arduino board.
 
 This tutorial works with **all** official Arduino boards.
 
-***Note: The cloud editor is previously known as the "Create Editor", or "Web Editor".***
+***Note: The Cloud Editor is previously known as the "Create Editor", or "Web Editor".***
 
 ## Goals
 
@@ -24,18 +24,18 @@ In this tutorial, we will achieve the following:
 
 ## Hardware & Software Needed
 
-- [Arduino Web Editor](https://create.arduino.cc/editor)
+- [Arduino Cloud Editor](https://create.arduino.cc/editor)
 - [Create Agent](https://create.arduino.cc/getting-started/plugin/welcome)
 - Arduino board
 - USB cable (different depending on the board you are using).
 
 ## Setting up the Cloud Editor
 
-We will now go through the necessary steps to get your Arduino board working with the Web Editor.
+We will now go through the necessary steps to get your Arduino board working with the Cloud Editor.
 
 ### Create an Account
 
-The first step is to create an account. This is done by navigating to login.arduino.cc/login. Here, you can either manually create an account, or login using for example Google.
+The first step is to create an account. This is done by navigating to the [Log-in page](login.arduino.cc/login). Here, you can either manually create an account, or log in using for example Google.
 
 ![Log in to your Arduino account.](assets/WebEditorInstall_1.png)
 
@@ -45,13 +45,15 @@ Once you have created and activated your account, we need to install the **Creat
 
 ![Installing.](assets/WebEditorInstall_2.png)
 
+The Create Agent is a piece of software that runs on your computer, and acts as a bridge between your board and your browser. Without it, the browser is not able to see what board you have connected to your computer, or upload code to it.
+
 Follow the instructions at this page to complete the installation. You will need to download the Create Agent in this process, and install it locally on your machine.
 
 When we are done, we should see this screen:
 
 ![Agent successfully installed.](assets/WebEditorInstall_3.png)
 
-Congratulations, you now have the necessary tools to start using the Web Editor.
+Congratulations, you now have the necessary tools to start using the Cloud Editor.
 
 > You can find the Arduino Create Agent files by following the path that relates to your operative system:
 > 
@@ -63,11 +65,11 @@ Congratulations, you now have the necessary tools to start using the Web Editor.
 
 ## Upload a Program
 
-Now, let's take a look at how the Web Editor works, by uploading a simple example to the board. First, we need to navigate to the Web Editor, by either [clicking this link](https://create.arduino.cc/editor) or clicking the menu at the top right corner, following the image below:
+Now, let's take a look at how the Cloud Editor works, by uploading a simple example to the board. First, we need to navigate to the Cloud Editor, by either [clicking this link](https://create.arduino.cc/editor) or clicking the menu at the top right corner, following the image below:
 
-![Clicking on the Web Editor button.](assets/WebEditorInstall_4.png)
+![Clicking on the Cloud Editor button.](assets/WebEditorInstall_4.png)
 
-Once you are in the Web Editor, you can see any board that you have connected to the computer. In this case, we have a **Arduino MKR WiFi 1010** at port **COM29** connected. Yours may look differently. This means that the board is recognized and the Create Agent is working.
+Once you are in the Cloud Editor, you can see any board that you have connected to the computer. In this case, we have a **Arduino MKR WiFi 1010** at port **COM29** connected. Yours may look differently. This means that the board is recognized and the Create Agent is working.
 
 ![Check if connected boards can be found.](assets/WebEditorInstall_5.png)
 
@@ -85,4 +87,4 @@ Once it is uploaded, there should be a message in the bottom of the editor sayin
 Success. Saved on your online Sketchbook and done uploading Blink.
 ```
 
-If we look at the board we uploaded the code to, we should see the onboard LED blink with an interval of 1 second. This means that you have successfully used the Web Editor to upload a code to your board.
+If we look at the board we uploaded the code to, we should see the onboard LED blink with an interval of 1 second. This means that you have successfully used the Cloud Editor to upload a code to your board.

content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md

@@ -1,11 +1,13 @@
 ---
 title: 'Arduino / C++'
-description: 'Get started with the Arduino Cloud using the Arduino / C++ programming language.'
+description: 'Get started with the Arduino Cloud using the C++ programming language.'
 tags: [Arduino Cloud, Setup]
 author: 'Karl Söderby'
 ---
 
-The default option for programming your board to connect to the Arduino Cloud is by using the **Arduino / C++ language**. The configuration and connection between your board and the Arduino Cloud is supported by the [ArduinoIoTCloud library](https://github.com/arduino-libraries/ArduinoIoTCloud) & [Arduino_ConnectionHandler](https://github.com/arduino-libraries/Arduino_ConnectionHandler) libraries.
+The default option for programming your board to connect to the Arduino Cloud is by using the **C++ language**. The configuration and connection between your board and the Arduino Cloud is supported by the [ArduinoIoTCloud library](https://github.com/arduino-libraries/ArduinoIoTCloud) & [Arduino_ConnectionHandler](https://github.com/arduino-libraries/Arduino_ConnectionHandler) libraries.
+
+***When programming in C++, you can use the Arduino API (which is also known as the Arduino Language). To learn more about the Arduino API, check out the [language reference](https://www.arduino.cc/reference/en/).***
 
 Whenever you create a [Thing](/arduino-cloud/cloud-interface/things) in the Arduino Cloud, you automatically start generating a set of files that will handle the configurations, credentials & connection:
 - `<sketchname>.ino` - your main sketch file,

content/arduino-cloud/01.guides/03.micropython/content.md

@@ -17,6 +17,8 @@ This tutorial guides you on how to use the MicroPython library to connect your A
 
 It requires your board to have a version of MicroPython installed, which is covered in [this article](/micropython/basics/board-installation).
 
+To find our full MicroPython documentation, head over to the [MicroPython Docs](/micropython) page.
+
 ## Goals
 
 The goals of this tutorial are:
@@ -128,6 +130,8 @@ $ mpremote connect id:335B34603532 mip install github:arduino/arduino-iot-cloud-
 This will install the library and all required dependencies on the board.
 Another option is to manually copy the files from the library's [repository](https://github.com/arduino/arduino-iot-cloud-py/tree/main/src/arduino_iot_cloud) to the board's file system. It's good practice to put those files into a folder called `lib` to have the files organized neatly.
 
+For more options on how to install libraries on your board, check out our [Installing Modules Guide](/micropython/basics/installing-modules). 
+
 ## Programming the Board
 
 Here is the example code to copy and paste into your sketch. It connects your device

content/arduino-cloud/01.guides/04.python/python.md

@@ -11,9 +11,10 @@ libraries:
     url: https://github.com/arduino/arduino-iot-cloud-py
 ---
 
+***It is recommended to have some experience with the Python environment before reading this guide. However, installation and setup is covered in the [Python Setup](#python-setup) section.***
+
 The [Arduino IoT Cloud Python Client](https://pypi.org/project/arduino-iot-cloud/) is a library that allows you to interact with the Arduino Cloud via MQTT. It supports basic authentication using the **device ID** as well as **secret key** that is obtained from the Arduino Cloud when configuring a manual device.
 
-***It is recommended to have some experience with the Python environment before reading this guide. However, installation and setup is covered in the [Python Setup](#python-setup) section.***
 
 ## Overview
 
@@ -32,7 +33,7 @@ To follow this guide, make sure to have:
 - [Arduino IoT Python Client](https://pypi.org/project/arduino-iot-client/) installed.
 - A code editor (we recommend [VSCode](https://code.visualstudio.com/) with the Python extension installed).
 
-***The experience with Python and the **pip**** package **manager** varies depending** on your computer and operating system. Python needs to be in your PATH to use the Arduino IoT Cloud Python client.***
+***The experience with Python and the pip package manager varies depending on your computer and operating system. Python needs to be in your PATH to use the Arduino IoT Cloud Python client.***
 
 ## Cloud Setup