Julian feedback applied all 4 tutorials

Author: mcmchris

content/hardware/03.nano/boards/nano-matter/tutorials/matter-fan/content.md

@@ -1,8 +1,8 @@
 ---
-title: 'Matter Smart Fan'
+title: 'Matter Smart Fan with the Arduino Nano Matter'
 difficulty: beginner
 compatible-products: [nano-matter]
-description: 'Learn how to build a Matter fan with speed control.'
+description: 'Learn how to build a Matter fan with speed control using the Arduino Nano Matter'
 tags:
   - IoT
   - Matter
@@ -21,11 +21,11 @@ software:
 
 ## Overview
 
-This tutorial will teach you how to create a Matter fan for keeping you cool. 
+This tutorial will teach you how to use the Arduino Nano Matter to create a Matter fan to keep you cool. 
 
 ![Matter fan overview](assets/thumbnail-v4.png)
 
-Thanks to the seamless compatibility of the Nano Matter with almost any Matter network we can easily integrate our fan with Amazon Alexa, Google Assistant, Apple Home, Home Assistant and even custom assistants.
+Thanks to the seamless compatibility of the Nano Matter with almost any Matter network we can easily integrate our fan with Amazon Alexa, Google Assistant, Apple Home, Home Assistant and even any professional custom solution.
 
 We have prepared a short demo in video format in case you are a visual learner.
 
@@ -34,7 +34,7 @@ We have prepared a short demo in video format in case you are a visual learner.
 ## Hardware and Software Requirements
 ### Hardware Requirements
 
-- [Nano Matter](https://store.arduino.cc/products/nano-matter) (x1)
+- [Arduino Nano Matter](https://store.arduino.cc/products/nano-matter) (x1)
 - Grove motor driver module (x1)
 - DC motor (x1)
 - Breadboard (x1)
@@ -71,6 +71,8 @@ Use the following connection diagram for the project:
 
 ![Project wiring diagram](assets/diagram-v4.png)
 
+The motor driver module is powered by the `3.3V` Nano Matter output pin. The motor speed is controlled by a PWM signal generated by the pin `D4`.
+
 ### Programming
 
 In the Arduino IDE upper menu, navigate to **Tools > Protocol stack** and select **Matter**.
@@ -189,17 +191,18 @@ void decommission_handler()
 }
 ```
 
-This is a very simple code that consist of the Arduino basic sketch parts:
+The structure of this example code is very simple, the main functions are explained below:
+
 - In the `setup()` function we initialize the Matter connectivity and the fan output pin. 
 - In the `loop()` function we listen to any fan control command sent from the smartphone or voice assistant and then adjust the fan speed setting the PWM signal accordingly.
 
 Once you uploaded the example code to the Nano Matter, open the Serial Monitor and reset the board.
 
 ![QR Code URL](assets/serial-monitor-v4.png)
 
-There you will find the URL that generates the QR for the Matter device commissioning.
+After the reset you will find on the serial port the URL that generates the QR for the Matter device commissioning.
 
-### Commissioning 
+### Adding the Device (Commissioning)
 
 Copy and paste the QR code URL on your favorite web browser and a unique QR code will be generated for your board.
 
@@ -217,7 +220,7 @@ Finally, you will be able to control the fan from your smartphone, hub or asking
 
 ## Conclusion
 
-In this tutorial we have learned how to create a Matter enabled fan that can be controlled from our smartphone and personal assistant. The Nano Matter allows us to seamlessly integrate the fan as a commercial product with our current smart home ecosystem.
+In this tutorial we have learned how to create a Matter enabled fan that can be controlled from our smartphone and personal assistant. The Nano Matter allows us to seamlessly integrate our own custom or old fan as a commercial product with our current smart home ecosystem.
 
 ### Next Steps
 

content/hardware/03.nano/boards/nano-matter/tutorials/matter-relay-lightbulb/content.md

@@ -1,8 +1,8 @@
 ---
-title: 'Matter Smart Relay'
+title: 'Matter Smart Relay with the Arduino Nano Matter'
 difficulty: beginner
 compatible-products: [nano-matter]
-description: 'Learn how to build a Matter smart relay to control an AC lightbulb.'
+description: 'Learn how to build a Matter smart relay to control an AC lightbulb using the Arduino Nano Matter'
 tags:
   - IoT
   - Matter
@@ -21,11 +21,11 @@ software:
 
 ## Overview
 
-This tutorial will teach you how to create a Matter smart relay to control an AC lightbulb. 
+This tutorial will teach you how to use the Arduino Nano Matter to create a Matter smart relay to control an AC lightbulb. 
 
 ![Smart relay overview](assets/thumbnail-v3.png)
 
-Thanks to the seamless compatibility of the Nano Matter with almost any Matter network we can easily integrate our smart relay with Amazon Alexa, Google Assistant, Apple Home, Home Assistant and even custom assistants.
+Thanks to the seamless compatibility of the Nano Matter with almost any Matter network we can easily integrate our smart relay with Amazon Alexa, Google Assistant, Apple Home, Home Assistant and even any professional custom solution.
 
 We have prepared a short demo in video format in case you are a visual learner.
 
@@ -34,7 +34,7 @@ We have prepared a short demo in video format in case you are a visual learner.
 ## Hardware and Software Requirements
 ### Hardware Requirements
 
-- [Nano Matter](https://store.arduino.cc/products/nano-matter) (x1)
+- [Arduino Nano Matter](https://store.arduino.cc/products/nano-matter) (x1)
 - Grove Relay Module (x1)
 - Lightbulb socket (x1)
 - AC lightbulb (x1)
@@ -73,6 +73,8 @@ Use the following connection diagram for the project:
 
 ![Project wiring diagram](assets/diagram-v3.png)
 
+The relay module is powered by the Nano Matter `3.3V` pin and the relay is controlled with the `D4` pin. Wire the AC cable with the lightbulb so the relay interrupts the current path when open.
+
 ***Be careful when handling with main voltages.***
 
 ### Programming
@@ -191,17 +193,18 @@ void decommission_handler()
 
 ```
 
-This is a very simple code that consist of the Arduino basic sketch parts:
+The structure of this example code is very simple, the main functions are explained below:
+
 - In the `setup()` function we initialize the Matter connectivity and the relay output pin. 
 - In the `loop()` function we listen to any relay toggle command sent from the smartphone or voice assistant.
 
 Once you uploaded the example code to the Nano Matter, open the Serial Monitor and reset the board.
 
 ![QR Code URL](assets/serial-monitor-v3.png)
 
-There you will find the URL that generates the QR for the Matter device commissioning.
+After the reset you will find on the serial port the URL that generates the QR for the Matter device commissioning.
 
-### Commissioning 
+### Adding the Device (Commissioning)
 
 Copy and paste the QR code URL on your favorite web browser and a unique QR code will be generated for your board.
 
@@ -219,7 +222,7 @@ Finally, you will be able to control the AC lightbulb from your smartphone, hub
 
 ## Conclusion
 
-In this tutorial we have learned how to create a Matter enabled smart relay that can be controlled from our smartphone and personal assistant. The Nano Matter allows us to seamlessly integrate the smart relay as a commercial product with our current smart home ecosystem.
+In this tutorial we have learned how to create a Matter enabled smart relay that can be controlled from our smartphone and personal assistant. The Nano Matter allows us to seamlessly integrate our own smart relay as a commercial product with our current smart home ecosystem.
 
 ### Next Steps
 

content/hardware/03.nano/boards/nano-matter/tutorials/matter-rgb-light/content.md

@@ -1,8 +1,8 @@
 ---
-title: 'Matter RGB Light'
+title: 'Matter RGB Light with the Arduino Nano Matter'
 difficulty: beginner
 compatible-products: [nano-matter]
-description: 'Learn how to build a Matter RGB light.'
+description: 'Learn how to build a Matter RGB light using the Arduino Nano Matter'
 tags:
   - IoT
   - Matter
@@ -21,11 +21,11 @@ software:
 
 ## Overview
 
-This tutorial will teach you how to create a Matter RGB Lightbulb to light up any room with colors. 
+This tutorial will teach you how to use the Arduino Nano Matter to create a Matter RGB Lightbulb to light up any room with colors. 
 
 ![RGB light overview](assets/thumbnail-v2.png)
 
-Thanks to the seamless compatibility of the Nano Matter with almost any Matter network we can easily integrate our RGB light with Amazon Alexa, Google Assistant, Apple Home, Home Assistant and even custom assistants.
+Thanks to the seamless compatibility of the Nano Matter with almost any Matter network we can easily integrate our RGB light with Amazon Alexa, Google Assistant, Apple Home, Home Assistant and even any professional custom solution.
 
 We have prepared a short demo in video format in case you are a visual learner.
 
@@ -34,7 +34,7 @@ We have prepared a short demo in video format in case you are a visual learner.
 ## Hardware and Software Requirements
 ### Hardware Requirements
 
-- [Nano Matter](https://store.arduino.cc/products/nano-matter) (x1)
+- [Arduino Nano Matter](https://store.arduino.cc/products/nano-matter) (x1)
 - Grove - 8x8 RGB LED Matrix (x1)
 - Breadboard (x1)
 - Jumper wires
@@ -71,6 +71,8 @@ Use the following connection diagram for the project:
 
 ![Project wiring diagram](assets/diagram-v2.png)
 
+The RGB LED matrix is powered by the Nano Matter `3.3V` pin, and it is controlled using an I2C connection.
+
 ### Programming
 
 In the Arduino IDE upper menu, navigate to **Tools > Protocol stack** and select **Matter**.
@@ -239,7 +241,8 @@ void handle_button_press() {
   button_pressed = true;
 }
 ```
-This is a very simple code that consist of the Arduino basic sketch parts:
+The structure of this example code is very simple, the main functions are explained below:
+
 - In the `setup()` function we initialize the Matter connectivity and the RGB Matrix I2C communication. 
 - In the `loop()` function we listen to any request of controlling the lightbulb state or color and update the matrix respectively.
 - There are some other functions to handle button press or RGB matrix color setup.
@@ -248,9 +251,9 @@ Once you uploaded the example code to the Nano Matter, open the Serial Monitor a
 
 ![QR Code URL](assets/serial-monitor-v2.png)
 
-There you will find the URL that generates the QR for the Matter device commissioning.
+After the reset you will find on the serial port the URL that generates the QR for the Matter device commissioning.
 
-### Commissioning 
+### Adding the Device (Commissioning) 
 
 Copy and paste the QR code URL on your favorite web browser and a unique QR code will be generated for your board.
 
@@ -268,7 +271,7 @@ Finally, you will be able to control the RGB light from your smartphone, hub or
 
 ## Conclusion
 
-In this tutorial we have learned how to create a Matter enabled RGB light that can be controlled from our smartphone and personal assistant. The Nano Matter allows us to seamlessly integrate the light as a commercial product with our current smart home ecosystem.
+In this tutorial we have learned how to create a Matter enabled RGB light that can be controlled from our smartphone and personal assistant. The Nano Matter allows us to seamlessly integrate our own light as a commercial product with our current smart home ecosystem.
 
 ### Next Steps
 

content/hardware/03.nano/boards/nano-matter/tutorials/matter-temp-sensor/content.md

@@ -1,8 +1,8 @@
 ---
-title: 'Matter Temperature Sensor'
+title: 'Matter Temperature Sensor with the Arduino Nano Matter'
 difficulty: beginner
 compatible-products: [nano-matter]
-description: 'Learn how to build a Matter temperature sensor.'
+description: 'Learn how to build a Matter temperature sensor using the Arduino Nano Matter'
 tags:
   - IoT
   - Matter
@@ -20,11 +20,11 @@ software:
 
 ## Overview
 
-This tutorial will teach you how to create a Matter sensor to monitor your room or workplace temperature. 
+This tutorial will teach you how to use the Arduino Nano Matter to create a Matter sensor to monitor your room or workplace temperature. 
 
 ![Temperature sensor overview](assets/thumbnail-v1.png)
 
-Thanks to the seamless compatibility of the Nano Matter with almost any Matter network we can easily integrate our sensor with Amazon Alexa, Google Assistant, Apple Home, Home Assistant and even custom assistants.
+Thanks to the seamless compatibility of the Nano Matter with almost any Matter network we can easily integrate our sensor with Amazon Alexa, Google Assistant, Apple Home, Home Assistant and even any professional custom solution.
 
 We have prepared a short demo in video format in case you are a visual learner.
 
@@ -33,7 +33,7 @@ We have prepared a short demo in video format in case you are a visual learner.
 ## Hardware and Software Requirements
 ### Hardware Requirements
 
-- [Nano Matter](https://store.arduino.cc/products/nano-matter) (x1)
+- [Arduino Nano Matter](https://store.arduino.cc/products/nano-matter) (x1)
 - DHT11 Temperature and Humidity sensor (x1)
 - I2C OLED Display SSD1306 (x1)
 - Breadboard (x1)
@@ -71,6 +71,8 @@ Use the following connection diagram for the project:
 
 ![Project wiring diagram](assets/diagram-v1.png)
 
+The OLED display and the DHT temperature sensor are powered by the Nano Matter `3.3V` pin. The OLED display uses I2C for communication and the DHT sensor uses a one-wire digital communication connected to `D4`.
+
 ### Programming
 
 In the Arduino IDE upper menu, navigate to **Tools > Protocol stack** and select **Matter**.
@@ -191,17 +193,18 @@ void decommission_handler() {
 }
 ```
 
-This is a very simple code that consist of the Arduino basic sketch parts:
+The structure of this example code is very simple, the main functions are explained below:
+
 - In the `setup()` function we initialize the Matter connectivity, the OLED display and temperature sensor. 
 - In the `loop()` function we measure the temperature and update the device value to be monitored in the Matter network.
 
 Once you uploaded the example code to the Nano Matter, open the Serial Monitor and reset the board.
 
 ![QR Code URL](assets/serial-monitor.png)
 
-There you will find the URL that generates the QR for the Matter device commissioning.
+After the reset you will find on the serial port the URL that generates the QR for the Matter device commissioning.
 
-### Commissioning 
+### Adding the Device (Commissioning)
 
 Copy and paste the QR code URL on your favorite web browser and a unique QR code will be generated for your board.
 
@@ -221,9 +224,9 @@ You can also see the temperature value on the device OLED display.
 
 ## Conclusion
 
-In this tutorial we have learned how to create a Matter enabled temperature sensor that can be monitored from our smartphone and personal assistant. The Nano Matter allows us to seamlessly integrate the sensor as a commercial product with our current smart home ecosystem.
+In this tutorial we have learned how to create a Matter enabled temperature sensor that can be monitored from our smartphone and personal assistant. The Nano Matter allows us to seamlessly integrate our own sensor as a commercial product with our current smart home ecosystem.
 
 ### Next Steps
 
-You can take this solution even further by adding the humidity measuring capability of the DHT11 sensor and integrate it as a 2nd sensor to your Matter network.
+You can take this solution even further by adding the humidity measuring capability of the DHT11 sensor and integrate it as a second sensor to your Matter network.