Merge branch 'sebromero/max-carrier-launch' into canchebagur/max-carrier-getting-started

# Conflicts:
#	content/hardware/04.pro/carriers/portenta-max-carrier/compatibility.yml
#	content/hardware/04.pro/carriers/portenta-max-carrier/datasheet/assets/maxCarrierAssembly.png
#	content/hardware/04.pro/carriers/portenta-max-carrier/datasheet/assets/maxCarrierPowerTree.svg
#	content/hardware/04.pro/carriers/portenta-max-carrier/datasheet/datasheet.md
#	content/hardware/04.pro/carriers/portenta-max-carrier/product.md

Author: sebromero

.github/workflows/deploy-prd.yml

@@ -1,7 +1,9 @@
 name: Deploy to production
 
 on:
-  workflow_dispatch:
+  push:
+    branches:
+      - main
 
 jobs:
   build:

.github/workflows/deploy-stg.yml

@@ -4,12 +4,10 @@ on:
   workflow_dispatch:
   push:
     branches:
-      - main
       - ghaction
 
 jobs:
   build:
-    if: "github.repository == 'arduino/docs-content'"
     runs-on: ubuntu-latest
     env:
       REPO_ACCESS_TOKEN: ${{ secrets.REPO_ACCESS_TOKEN }}

.gitignore

@@ -1,6 +1,5 @@
 .babelrc
 .cache
-_templates
 algolia-queries.js
 envs
 gatsby-*

.vscode/launch.json

@@ -14,6 +14,17 @@
             "program": "validate.js",
             "args": ["-p", "../../content"],
             "cwd": "${workspaceFolder}/scripts/validation/"
+        },
+        {
+            "type": "pwa-node",
+            "request": "launch",
+            "name": "Debug Quickfix",
+            "skipFiles": [
+                "<node_internals>/**"
+            ],
+            "program": "fix-issues.js",
+            "args": ["-p", "../../content"],
+            "cwd": "${workspaceFolder}/scripts/validation/"
         }
     ]
 }

Power_Tree_Max_Carrier.svg

@@ -9,11 +9,22 @@ The production website is available at: <https://docs.arduino.cc>
 ## How Can I Contribute?
 
 Contributing by creating content or suggestion changes to existing content can be done by making **pull requests**.
+
 You start by forking the repository or by creating a new branch if you have write access to this repo. Create a new branch based on main and name it according to what you will create prefixed with your github username and a slash (e.g. `sebromero/wifi-tutorial`). Read in the section below how to add different types of new content.
 
 When you're done with a draft you can create a pull request. This will give the content team the possibility to review it and leave comments or request changes. During this review process you can continue to push commits to the same branch. They will show up in the pull request automatically.
+
 Once the pull request gests approved and merged into main, the content will be deployed to the live server.
 
+There are four different content types you can contribute with. These are **tutorial**, **article**, **how to** and **project**. Please read more on what they mean and how to write one in the [Contribution Templates folder](/contribution-templates/README.md).
+
+|Content|Description|Example|
+|-------|-----------|-------|
+|Tutorial|Learn how to do something.|[Control Built-in RGB LED over Wi-Fi with Nano RP2040 Connect](https://docs.arduino.cc/tutorials/nano-rp2040-connect/rp2040-web-server-rgb)|
+|Article|Learn about a specific topic.|[Multimeter Basics](https://docs.arduino.cc/learn/electronics/multimeter-basics)|
+|How To|Smaller tutorial with less information and more straight to the example.|[Analog Read Serial](https://docs.arduino.cc/built-in-examples/basics/AnalogReadSerial)|
+|Project|Learn how to build something.|[DIY Photoshop Editing Console using Arduino Nano RP2040 Connect](https://create.arduino.cc/projecthub/jithinsanal1610/diy-photoshop-editing-console-using-arduino-nano-rp-2040-a43e97?ref=search&ref_id=nano%20rp2040%20connect&offset=0)|
+
 ## Fixing Bugs and Typos
 
 If you found a mistake in the content you need to locate the corresponding file to fix it and create a pull request. Here is how to locate the content.
@@ -37,7 +48,7 @@ If you found a mistake in the content you need to locate the corresponding file
 
 ### Software
 
-- If you found an issue in a sofware product's tutorial they are located according to the following pattern:
+- If you found an issue in a software product's tutorial they are located according to the following pattern:
   `/content/software/[product-name]/tutorials/(tutorial-subfolder)/[tutorial-name]/[content-file].md`
 
 ## Adding Content

README.md

@@ -38,7 +38,7 @@ Connect your board to your computer with a micro-USB cable. The buttons are conn
 
 ![](assets/circuit.png)
 
-###Schematic 
+### Schematic 
 
 ![](assets/schematic.png)
 

content/built-in-examples/09.usb/ButtonMouseControl/ButtonMouseControl.md

@@ -12,7 +12,7 @@ tags:
 
 This example illustrates the use of the Mouse and Keyboard libraries together. Five momentary switches act as directional buttons for your cursor. When a button is pressed, the cursor on your screen will move, and a keypress, corresponding to the letter associated with the direction, will be sent to the computer. Once you have the Leonardo, Micro or Due programmed and wired up, open up your favorite text editor to see the results.
 
-**NB:  When you use the Mouse and Keyboard library functions, the Arduino takes over your computer's cursor! To insure you don't lose control of your computer while running a sketch with this function, make sure to set up a controller before you call Mouse.move().**
+**NB:  When you use the Mouse and Keyboard library functions, the Arduino takes over your computer's cursor! To ensure you don't lose control of your computer while running a sketch with this function, make sure to set up a controller before you call Mouse.move().**
 
 ### Hardware Required
 
@@ -57,4 +57,4 @@ You can find more basic tutorials in the [built-in examples](/built-in-examples)
 
 You can also explore the [language reference](https://www.arduino.cc/reference/en/), a detailed collection of the Arduino programming language.
 
-*Last revision 2015/07/29 by SM*
+*Last revision 2015/07/29 by SM*

content/built-in-examples/09.usb/ButtonMouseControl/assets/schematic.png

@@ -84,6 +84,8 @@ Connection through mobile networks can be considered in remote areas where there
 
 ***For more information, visit the [Arduino SIM page](https://store.arduino.cc/digital/sim).***
 
+***Note that a secured connection is a memory intense operation, so there's not a lot of memory for the user application (e.g. around 2.6 kB on the MKR GSM 1400). Using a lot of IoT Cloud variables may cause the sketch to run out of memory on boards which don't offload the SSL stack and make it crash.***
+
 ### ESP32 / ESP8266
 
 The Arduino IoT Cloud supports a wide range of third party boards based on the ESP32 and ESP8266 microcontrollers with support for Wi-Fi. To set them up, simply choose the **third party option** in the device setup.

content/built-in-examples/09.usb/KeyboardAndMouseControl/KeyboardAndMouseControl.md

@@ -7,12 +7,12 @@ software:
   - iot-cloud
 ---
 
-It is now possible to schedule jobs with the [Arduino IoT Cloud](https://create.arduino.cc/iot/), using the new `CloudSchedule` variable type. You can pick a start & end date for when the variable should be triggered, and for how long it should be active. This is done through the IoT Cloud dashboards.
+It is now possible to schedule jobs with the [Arduino IoT Cloud](https://create.arduino.cc/iot/), using the new `CloudSchedule` variable type. You can pick a start & end date for when the variable should be triggered, and for how long it should be active. This variable can be controlled in real time using a graphical widget that you can place on an IoT Cloud dashboard.
 
 We can for example have:
 
-- One trigger scheduled to go off every minute, and last for 10 seconds
-- One trigger scheduled to go off every hour, and last for 10 minutes.
+- One trigger scheduled to run every minute for 10 seconds
+- One trigger scheduled to run every hour for 10 minutes
 
 ## Goals
 
@@ -21,48 +21,18 @@ The goals of this project are:
 - Learn how the `CloudSchedule` variable works.
 - Learn how to access local time in your sketch.
 
-## Hardware & Software Needed
-
-For this tutorial, you will need a cloud compatible board. You can see the full list below:
-
-- [MKR 1000 WiFi](https://store.arduino.cc/arduino-mkr1000-wifi)
-- [MKR WiFi 1010](https://store.arduino.cc/arduino-mkr-wifi-1010)
-- [MKR GSM 1400](https://store.arduino.cc/arduino-mkr-gsm-1400)\*
-- [MKR NB 1500](https://store.arduino.cc/arduino-mkr-nb-1500-1413)\*
-- [Nano RP2040 Connect](https://store.arduino.cc/nano-rp2040-connect)
-- [Nano 33 IoT](https://store.arduino.cc/arduino-nano-33-iot)
-- [Portenta H7](https://store.arduino.cc/portenta-h7)
-
-***The MKR GSM 1400 & MKR NB 1500 requires a SIM card with a data plan to work. You can read more about it in [this page](https://store.arduino.cc/digital/sim).***
+Make sure you have a [cloud-compatible board](/cloud/iot-cloud/tutorials/technical-reference#compatible-hardware).
 
 ## How Does it Work?
 
-The working principle of the scheduler is pretty straight forward. The `CloudSchedule` variable can be configured to go off at a specific time, with a specific duration. In the code, you do not need to worry about any timers, as this is done in the Arduino IoT Cloud. The "jobs" are created in the dashboard, through a widget associated to the variable.
+A variable of `CloudSchedule` type can be configured to trigger at a specific time, with a specific duration. In the code, you do not need to worry about the logic for this. The configuration of the variable is done in the dashboard, through a widget associated to the variable.
 
-For example, we can set `schedule_variable` to be:
+For example, we can set such variable to be:
 - ON for 10 seconds, every minute.
 - ON for 8 hours, every day. 
 - ON for a week, and then finish.
 
-![Example of how a scheduler works.](assets/cloud-scheduler-img-01.png)
-
-## API
-
-The two **variables types** introduced in this tutorial are `CloudTime` and `CloudSchedule`. These are used to retrieve local time and to schedule a job respectively.
-
-The `CloudSchedule` variable is of a **complex type**. It has a **internal boolean state**, which can be checked through the `isActive()` function (returns `true` or `false`).
-
-```arduino
-if(schedule_variable.isActive()) {
-  //do something
-}
-```
-
-The `CloudTime` variable is an unsigned integer which is used to store current time. We can use the `getLocalTime()` function to retrieve local time.
-
-```arduino
-time_variable = ArduinoCloud.getLocalTime();
-```
+![Example of a schedule configured to run for 10 seconds every minute.](assets/cloud-scheduler-img-01.png)
 
 ## Application Examples
 
@@ -75,15 +45,12 @@ There are countless examples where schedulers can be used, but predominantly it
 To test out functionality of your scheduler job, we can turn on an LED while the job is active. 
 
 ```arduino
-// whenever the job is "active", turn on the LED
-if(schedule_variable.isActive()){
-digitalWrite(LED, HIGH);
-}
-
-
-// whenever the job is "not active", turn off the LED
-else{
-digitalWrite(LED, LOW);  
+if (schedule_variable.isActive()) {
+   // whenever the job is "active", turn on the LED
+   digitalWrite(LED, HIGH);
+} else {
+   // whenever the job is "not active", turn off the LED
+   digitalWrite(LED, LOW);  
 }
 ```
 
@@ -96,23 +63,22 @@ You can set up **multiple scheduler variables.** This way, you can have a differ
 - Change a string.
 
 ```arduino
-//scheduler 1 (write a high state to a pin)
-if(schedule_variable_1.isActive()){
-digitalWrite(3, HIGH);
-}
-else{
-digitalWrite(3, HIGH);
+// scheduler 1 (write a high state to a pin)
+if (schedule_variable_1.isActive()) {
+   digitalWrite(3, HIGH);
+} else {
+   digitalWrite(3, LOW);
 }
 
-//scheduler 2 (read a sensor)
-if(schedule_variable_2.isActive()){
-sensor_variable = analogRead(A1);
+// scheduler 2 (read a sensor)
+if(schedule_variable_2.isActive()) {
+   sensor_variable = analogRead(A1);
 }
 
-//scheduler 3 (change a string)
-if(schedule_variable_3.isActive()){
-string_variable = "";
-string_variable = "Update something here!";
+// scheduler 3 (change a string)
+if (schedule_variable_3.isActive()) {
+   string_variable = "";
+   string_variable = "Update something here!";
 }
 ```
 
@@ -122,14 +88,12 @@ string_variable = "Update something here!";
 Turning on and off light sources can be a great power saver for the office, home or vacation home. This can be achieved with a few lines of code and a [relay shield](https://store.arduino.cc/products/arduino-mkr-relay-proto-shield).
 
 ```arduino
-//can be configured to be ON between 8am - 5pm 
-if(schedule_variable.isActive()){
-digitalWrite(relay, HIGH);
-}
-
-//can be set to OFF between 5pm - 8am the next morning
-else{
-digitalWrite(relay, LOW);  
+if (schedule_variable.isActive()) {
+   // can be configured to be ON between 8am - 5pm 
+   digitalWrite(relay, HIGH);
+} else {
+   //can be set to OFF between 5pm - 8am the next morning
+   digitalWrite(relay, LOW);  
 }
 ```
 
@@ -140,25 +104,21 @@ digitalWrite(relay, LOW);
 For a "smart watering" setup, if you connect a pump through a relay, you can schedule a job to be on for a period of time (pumping water) and then turn off. This could for example occur for a few seconds every day to keep your plants alive.
 
 ```arduino
-//configure to be "on" for 10 seconds every day
-if(schedule_variable.isActive()){
-digitalWrite(pump, HIGH);
-}
-
-else{
-digitalWrite(pump, LOW);
+// configure to be "on" for 10 seconds every day
+if (schedule_variable.isActive()) {
+   digitalWrite(pump, HIGH);
+} else {
+   digitalWrite(pump, LOW);
 }
 ```
 
 Or, if you use a driver, such as **L298N**, you can control the pump through:
 
 ```arduino
-if(schedule_variable.isActive()){
-analogWrite(pump, 127); //range between 0-255
-}
-
-else{
-analogWrite(pump, 0);
+if (schedule_variable.isActive()) {
+   analogWrite(pump, 127); // range between 0-255
+} else {
+   analogWrite(pump, 0);
 }
 ```
 
@@ -171,6 +131,24 @@ In this section you will find a step by step tutorial that will guide you to cre
 - Create a basic sketch & upload it to the board.
 - Create a dashboard.
 
+### API
+
+The two **variables types** introduced in this tutorial are `CloudTime` and `CloudSchedule`. These are used to retrieve local time and to schedule a job respectively.
+
+The `CloudSchedule` variable is of a **complex type**. It has a **internal boolean state**, which can be checked through the `isActive()` function (returns `true` or `false`).
+
+```arduino
+if(schedule_variable.isActive()) {
+  //do something
+}
+```
+
+The `CloudTime` variable is an unsigned integer which is used to store current time. We can use the `getLocalTime()` function to retrieve local time.
+
+```arduino
+time_variable = ArduinoCloud.getLocalTime();
+```
+
 ### Create a Thing
 
 ***If you are new to the Arduino IoT Cloud, you can either visit the [Getting Started with Arduino IoT Cloud](https://docs.arduino.cc/cloud/iot-cloud/tutorials/iot-cloud-getting-started) guide, or any of the tutorials in the [Arduino IoT Cloud documentation](https://docs.arduino.cc/cloud/iot-cloud). There you will find detailed step by step guides.***

content/built-in-examples/09.usb/KeyboardAndMouseControl/assets/schematic.png

@@ -26,7 +26,6 @@ Windows XP may be polling your parallel port and disrupting the bootloader burni
 [HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\Parport\Parameters]
 "DisableWarmPoll"=dword:00000001
 ```
-See this [forum thread](http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?num=1142106610) for details.
 
 ## Versions of the Bootloader
 There are different versions of the bootloader - both in order to work on different hardware and because it has changed over time.

content/cloud/iot-cloud/tutorials/01.iot-cloud-getting-started/iot-cloud-getting-started.md

@@ -225,6 +225,6 @@ It's also nice to provide people with an example sketch that uses your library.
 
 If you'd like to check out the complete library (with keywords and example), you can download it: [Morse.zip](https://www.arduino.cc/en/uploads/Hacking/Morse.zip).
 
-That's all for now but I'll probably write an advanced library tutorial soon. In the meantime, if you have any problems or suggestions, please post them to the [Software Development forum](http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?board=dev).
+That's all for now but I'll probably write an advanced library tutorial soon. In the meantime, if you have any problems or suggestions, please post them to the [Software Development forum](https://forum.arduino.cc/c/development/libraries/39).
 
-For more information, see the [API Style Guide](https://www.arduino.cc/en/Reference/APIStyleGuide) for information on making a good Arduino-style API for your library.
+For more information, see the [API Style Guide](https://www.arduino.cc/en/Reference/APIStyleGuide) for information on making a good Arduino-style API for your library.

content/cloud/iot-cloud/tutorials/03.cloud-scheduler/cloud-scheduler.md

@@ -4,6 +4,8 @@ url_shop: https://store.arduino.cc/arduino-mkr1000-wifi
 url_guide: /software/ide-v1/installing-samd21-core
 core: arduino:samd
 forumCategorySlug: '/hardware/mkr-boards/mkr1000/137'
+status: end-of-life
+productCode: '017'
 ---
 
 The Arduino MKR 1000 WiFi is the easiest point of entry to basic IoT and pico-network application design. Whether you are looking at setting up a sensor network for your office or building a smart home, the MKR 1000 WiFi will make that journey easy.

content/hacking/01.software/Bootloader/Bootloader.md

@@ -56,13 +56,13 @@ Defines the correspondence between notes and MIDI note values. Part of MIDIUSB
 
 ### Functions In Sketch
 
-*searchForNote(float frequency)*
+**searchForNote(float frequency)**
 Search for the nearest frequency that is in the vector of frequencies noteFrequency[ ]
 
-*noteOn(byte channel, byte pitch, byte velocity)*
+**noteOn(byte channel, byte pitch, byte velocity)**
 Sends out to MIDI the event to turn on the note of the specified pitch on the specified MIDI Channel
 
-*void noteOff(byte channel, byte pitch, byte velocity)*
+**void noteOff(byte channel, byte pitch, byte velocity)**
 Sends out to MIDI the event to turn off  the note of the specified pitch on the specified MIDI Channel
 
 ## Code

content/hacking/01.software/LibraryTutorial/LibraryTutorial.md

@@ -202,4 +202,4 @@ void printWifiStatus() {
 
 
 
-*Last revision 2017/03/24 by AG*
+**Last revision 2017/03/24 by AG**