update all links

karlsoderby · karlsoderby · commit 7601249baac5 · 2023-11-03T13:45:39.000+01:00
diff --git a/content/arduino-cloud/00.guides/01.overview/overview.md b/content/arduino-cloud/00.guides/01.overview/overview.md
@@ -38,7 +38,7 @@ Networking code and data synchronizing is **automatically done**, so just focus
 
 Compatibility with the Arduino Cloud is divided into two categories: 
 - **Cloud Editor Support** - you can program **any** official Arduino board in the cloud editor. The editor also supports a large amount of third party boards.
-- **IoT Cloud Support** - board with a radio module (e.g. Wi-Fi®) are supported. ESP32 based boards are also supported. 
+- **IoT Support** - board with a radio module (e.g. Wi-Fi®) are supported. ESP32 based boards are also supported. 
 
 For more information and list of supported boards, see the links below:
 - [Wi-Fi®](/arduino-cloud/hardware/wifi)
diff --git a/content/arduino-cloud/00.guides/02.arduino-c/arduino-c.md b/content/arduino-cloud/00.guides/02.arduino-c/arduino-c.md
@@ -1,19 +1,17 @@
 ---
 title: 'Arduino / C++'
-description: 'Get started with the Arduino IoT Cloud using the Arduino / C++ programming language.'
-tags: [IoT Cloud, Setup]
+description: 'Get started with the Arduino Cloud using the Arduino / C++ programming language.'
+tags: [Arduino Cloud, Setup]
 author: 'Karl Söderby'
 ---
 
-The default option for programming your board to connect to the Arduino IoT Cloud is by using the **Arduino / C++ language**. The configuration and connection between your board and the IoT 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 **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.
 
-Whenever you create a [Thing](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/cloud-interface/things) in the IoT Cloud, you automatically start generating a set of files that will handle the configurations, credentials & connection:
+Whenever you create a [Thing](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/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,
 - `thingProperties.h` - your main configuration file,
 - `arduino_secrets.h` - your credentials file (for API key, Wi-Fi network etc.)
 
-In this guide, we will take a look at how you can connect to the IoT Cloud using the Arduino / C++ programming language.
-
 ***If you want to find out more about what the Arduino Cloud service can do, go to the [overview](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/guides/overview) section.*** 
 
 ## Requirements
@@ -23,19 +21,19 @@ In this guide, we will take a look at how you can connect to the IoT Cloud using
 
 ## Setup
 
-In this section, we will go through the steps necessary to connect your Arduino board to the IoT Cloud. To follow these steps, please make sure you have a [registered Arduino account](https://login.arduino.cc/login), and that you have access to the [Arduino Cloud](app.arduino.cc).
+In this section, we will go through the steps necessary to connect your Arduino board to the Arduino Cloud. To follow these steps, please make sure you have a [registered Arduino account](https://login.arduino.cc/login), and that you have access to the [Arduino Cloud](app.arduino.cc).
 
 ### Configure Device
 
-First navigate to [IoT Cloud](app.arduino.cc), and click on the **Devices** tab. Here you can see all your devices, and configure a new one. Depending on what type of board you have, the configuration will vary. 
+First navigate to [Arduino Cloud](app.arduino.cc), and click on the **Devices** tab. Here you can see all your devices, and configure a new one. Depending on what type of board you have, the configuration will vary. 
 
-***For more details, see the [documentation for IoT Cloud devices](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/hardware/devices).***
+***For more details, see the [documentation for devices](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/hardware/devices).***
 
 ### Configure Thing
 
 Next, navigate to the **Things** tab. Here you will see a list of your Things, and a button to create a new one. When you create a new Thing, you will open up a new configuration space.
 
-![Arduino IoT Cloud Thing Interface](assets/thing-config.png)
+![Arduino Cloud Thing Interface](assets/thing-config.png)
 
 A "Thing" is a virtual twin of your hardware, and it is here that we create variables that we want to synchronize between the cloud and board. Any changes we make here will be reflected in an [automatically generated sketch](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/cloud-interface/sketches#iot-sketches).
 
@@ -45,7 +43,7 @@ A "Thing" is a virtual twin of your hardware, and it is here that we create vari
 
 All the above configurations have now been generated into a set of files that can be accessed in the **Sketch** tab.
 
-***For more details, see the [documentation for IoT Cloud Things](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/cloud-interface/things).***
+***For more details, see the [documentation for Things](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/cloud-interface/things).***
 
 ### Complete Sketch
 
@@ -110,6 +108,4 @@ To control the state of the `test` variable, we can setup a **dashboard** and a
 2. Click on the edit button at the top left, then on the **"Add"** button. Select the Thing you want to associate it with, and then click on **"Create Widgets"**.
 3. A switch widget will have generated, which is now linked to your board. Flicking it should control the state of the LED (on/off).
 
-![Controlling built-in LED via a switch widget.]()
-
-***You can find more details in the [Arduino IoT Cloud dashboards documentation](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/cloud-interface/dashboard-widgets).***
+***You can find more details in the [dashboards documentation](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/cloud-interface/dashboard-widgets).***
diff --git a/content/arduino-cloud/00.guides/03.micropython/assets/get-key.png b/content/arduino-cloud/00.guides/03.micropython/assets/get-key.png
diff --git a/content/arduino-cloud/00.guides/03.micropython/content.md b/content/arduino-cloud/00.guides/03.micropython/content.md
@@ -12,7 +12,7 @@ libraries:
 
 ## Introduction 
 
-This tutorial guides you on how to use the MicroPython library to connect your Arduino device to the Arduino IoT Cloud. 
+This tutorial guides you on how to use the MicroPython library to connect your Arduino device to the Arduino Cloud. 
 
 It requires your board to have a version of MicroPython installed, which is covered in [this article](/micropython/basics/board-installation).
 
diff --git a/content/arduino-cloud/02.hardware/01.devices/assets/device-key.png b/content/arduino-cloud/02.hardware/01.devices/assets/device-key.png
diff --git a/content/arduino-cloud/02.hardware/01.devices/devices.md b/content/arduino-cloud/02.hardware/01.devices/devices.md
@@ -50,7 +50,7 @@ LoRaWAN® boards also have crypto chip on board, but connects to the Arduino Clo
 
 ### ESP32 / ESP8266 (Wi-Fi®)
 
-ESP32/ESP8266 based boards typically don't have an onboard crypto chip, and is configured via a **Secret Key** generated during the configuration.
+ESP32/ESP8266 based boards typically don't have an onboard crypto chip. Instead when configuring a device, a **[secret key](#secret-key--device-id)** is generated, that can together with the **device ID** be used to securely connect to the Arduino Cloud.
 
 There are currently two official ESP32 based Arduino boards:
 - [Arduino UNO R4 WiFi](https://store.arduino.cc/products/uno-r4-wifi)
@@ -62,7 +62,7 @@ You can also configure a wide range of third party ESP32/ESP8266 boards.
 
 ### Manual Devices
 
-Manual devices are designed for interfacing with JavaScript, Python & MicroPython, and can for example run on an Raspberry Pi, but also on any . Creating a manual device generates a **secret key** that can together with the device ID be used to securely connect to the Arduino Cloud.
+Manual devices are designed for interfacing with JavaScript, Python & MicroPython, and can for example run on an Raspberry Pi, but also on any . Creating a manual device generates a **[secret key](#secret-key--device-id)** that can together with the **device ID** be used to securely connect to the Arduino Cloud.
 
 ***Note that manual devices do not have a sketch associated.***
 
@@ -72,6 +72,13 @@ Check the guides below for getting started with each of the programming language
 - [Connect to Arduino Cloud (Python)](/arduino-cloud/guides/python)
 - [Connect to Arduino Cloud (MicroPython)](/arduino-cloud/guides/micropython)
 
+## Secret Key & Device ID
+
+When configuring ESP32/ESP8266 and Manual Devices, you generate a **Device ID** and a **Secret Key**. This is the final step of the configuration of your device.
+
+![Your Device ID / Secret Key.](assets/device-key.png)
+
+Make sure to download or store this information somewhere, as you cannot retrieve the Secret Key after this step.
 
 ## Device Information
 
diff --git a/content/arduino-cloud/07.api/03.c-library/c-library.md b/content/arduino-cloud/07.api/03.c-library/c-library.md
@@ -1,13 +1,13 @@
 ---
 title: Arduino / C++ Library
-description: 
+description: The ArduinoIoTCloud library allows you to connect to the Arduino Cloud using Arduino/C++. 
 author: Karl Söderby
 tags: [C++, Arduino]
 ---
 
-The default Arduino / C++ library for the Arduino Cloud is the [ArduinoIoTCloud]() library. This library depends on the [Arduino_ConnectionHandler]() library which provides connection via various wireless protocols (Wi-Fi®, LoRaWAN®, NB-IoT, GSM, Ethernet). 
+The default Arduino / C++ library for the Arduino Cloud is the [ArduinoIoTCloud](https://github.com/arduino-libraries/ArduinoIoTCloud) library. This library depends on the [Arduino_ConnectionHandler](https://github.com/arduino-libraries/Arduino_ConnectionHandler) library which provides connection via various wireless protocols (Wi-Fi®, LoRaWAN®, NB-IoT, GSM, Ethernet). 
 
-The library is integrated into the Arduino Cloud platform, where [Automatic Sketch Generation]() converts your Thing configurations into a set files that relies on aforementioned libraries.
+The library is integrated into the Arduino Cloud platform, where [Automatic Sketch Generation](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/cloud-interface/sketches#iot-sketches) converts your Thing configurations into a set files that relies on aforementioned libraries.
 
 The **ArduinoIoTCloud** library supports either connection via **TCP/IP** or **LoRaWAN®**. Depending on the device you compile for, the library automatically chooses the right configuration.
 
@@ -28,13 +28,13 @@ When connecting via [TCP/IP](https://en.wikipedia.org/wiki/Internet_protocol_sui
 
 ### LoRaWAN®
 
-When connecting via LoRaWAN®, data is sent via [The Things Network](), which is integrated with the Arduino Cloud. This support is enabled in the following files:
+When connecting via LoRaWAN®, data is sent via [The Things Network](https://www.thethingsnetwork.org/), which is integrated with the Arduino Cloud. This support is enabled in the following files:
 - [ArduinoIoTCloudLPWAN.cpp](https://github.com/arduino-libraries/ArduinoIoTCloud/blob/master/src/ArduinoIoTCloudLPWAN.cpp)
 - [ArduinoIoTCloudLPWAN.h](https://github.com/arduino-libraries/ArduinoIoTCloud/blob/master/src/ArduinoIoTCloudLPWAN.h)
 
 ## Library API Docs
 
-The documentation lives in the [ArduinoIoTCloud]() library documentation page. Here you will find all public methods that are available. 
+The documentation lives in the [ArduinoIoTCloud](https://github.com/arduino-libraries/ArduinoIoTCloud) library documentation page. Here you will find all public methods that are available. 
 
 Most of its functions are already pre-configured in your sketch files, so for most use cases you will not need to explore the API. Functions for connecting to, and syncing data with the Arduino Cloud is handled automatically, and will be generated into your sketch files in the web environment. 
 
diff --git a/content/arduino-cloud/07.api/04.python/python.md b/content/arduino-cloud/07.api/04.python/python.md
@@ -7,7 +7,7 @@ tags: [Python, Arduino Cloud]
 
 The Python Client for connecting to the Arduino Cloud is known as the [Arduino IoT Cloud Python Client](https://github.com/arduino/arduino-iot-cloud-py) library. This library is implemented to support MicroPython, CircuitPython as well as regular Python running on your personal computer / Linux machine (like Raspberry Pi).
 
-Connection via this client is achieved by registering a [manual device](), i.e. a virtual device that is not associated with an Arduino hardware board. This virtual device can connect through a simple username/password (Device ID, Secret Key) which is generated in the Arduino Cloud when configuring a device.
+Connection via this client is achieved by registering a [manual device](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/hardware/devices#manual-devices), i.e. a virtual device that is not associated with an Arduino hardware board. This virtual device can connect through a simple username/password (Device ID, Secret Key) which is generated in the Arduino Cloud when configuring a device.
 
 ## GitHub
 
@@ -16,11 +16,11 @@ To view the source code and report issues, follow the links below to the GitHub
 
 ## Installation
 
-You can install this client either directly on your board running MicroPython
+You can install this client either directly on your board running **MicroPython**, or on any computer using **Python**.
 
 ### MicroPython
 
-To install the client on a board running MicroPython, you can check out the [MicroPython Installation Guide](). Options to directly download the library to the board via Wi-Fi® or via USB is available, using [mip](https://docs.micropython.org/en/latest/reference/packages.html). 
+To install the client on a board running MicroPython, you can check out the [MicroPython Installation Guide](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/guides/micropython). Options to directly download the library to the board via Wi-Fi® or via USB is available, using [mip](https://docs.micropython.org/en/latest/reference/packages.html). 
 
 ### Python
 
@@ -32,7 +32,7 @@ pip install arduino-iot-cloud
 
 Project description, release history and more information about this package can be found [here](https://pypi.org/project/arduino-iot-cloud/).
 
-***Need help setting up? Check out the [Python Installation Guide](), which has ready made examples that will help you get started.***
+***Need help setting up? Check out the [Python Installation Guide](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/guides/python), which has ready made examples that will help you get started.***
 
 ## Variable Synchronisation
 
@@ -42,4 +42,4 @@ Variable synchronisation is a feature of the Arduino Cloud that allows you to sy
 
 With this feature, you can very easily integrate your existing Python, MicroPython or JavaScript projects with your Arduino projects. 
 
-***Read more in the [Variable Synchronisation]() section.***
+***Read more in the [Variable Synchronisation](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/cloud-interface/variables#variable-synchronisation) section.***
diff --git a/content/arduino-cloud/07.api/05.javascript/javascript.md b/content/arduino-cloud/07.api/05.javascript/javascript.md
@@ -7,9 +7,9 @@ tags: [JavaScript, Arduino Cloud]
 
 This library provides interaction with the Arduino IoT Cloud MQTT broker and can be used both from the browser and Node.js.
 
-Connection via this library is achieved by registering a [manual device](), i.e. a virtual device that is not associated with an Arduino hardware board. This virtual device can connect through a simple username/password (Device ID, Secret Key) which is generated in the Arduino Cloud when configuring a device.
+Connection via this library is achieved by registering a [manual device](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/hardware/devices#manual-devices), i.e. a virtual device that is not associated with an Arduino hardware board. This virtual device can connect through a simple username/password (Device ID, Secret Key) which is generated in the Arduino Cloud when configuring a device.
 
-This library requires a version of [Node.js]() to be installed on your machine.
+This library requires a version of [Node.js](https://nodejs.org/en/download/current) to be installed on your machine.
 
 ## GitHub
 
@@ -18,7 +18,7 @@ To view the source code and report issues, follow the links below to the GitHub
 
 ## Requirements
 
-- [Node.js]()
+- [Node.js](https://nodejs.org/en/download/current)
 
 ## Installation
 
@@ -34,7 +34,7 @@ $ npm install arduino-iot-js
 $ yarn add arduino-iot-js
 ```
 
-***Check out the [JavaScript Setup guide]() for more information and a detailed step by step tutorial.***  
+***Check out the [JavaScript Setup guide](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/guides/javascript) for more information and a detailed step by step tutorial.***  
 
 ## Connection Methods
 
@@ -45,7 +45,7 @@ There are three available methods for connection:
 
 ### Device Credentials
 
-Device credentials is the easiest method. These credentials are generated when [configuring a manual device]() in the Arduino Cloud, and works like a username/password. The example below uses device credentials:
+[Device credentials](https://docscontentprivate-karlsoderbycloudv2.gatsbyjs.io/arduino-cloud/hardware/devices#secret-key--device-id) is the easiest method. These credentials are generated when configuring a manual device in the Arduino Cloud, and works like a username/password. The example below uses device credentials:
 
 ```js
 //JavaScript code
@@ -71,7 +71,7 @@ const { ArduinoIoTCloud } = require('arduino-iot-js');
 
 ### API Key
 
-You can also connect using an API key generated from the [Arduino Cloud API Key Section](), a method that is almost identical to Device Credentials, but where you also need to specify your Thing ID. This is available in the metadata section of your Thing.
+You can also connect using an API key generated from the [Arduino Cloud API Key Section](app.arduino.cc/api-keys), a method that is almost identical to Device Credentials, but where you also need to specify your Thing ID. This is available in the metadata section of your Thing.
 
 ```js
 import { ArduinoIoTCloud } from 'arduino-iot-js';
diff --git a/content/arduino-cloud/11.application-notes/cloud-relay-control/cloud-relay-control.md b/content/arduino-cloud/11.application-notes/cloud-relay-control/cloud-relay-control.md
