Apply suggestions from code review

 Remaining suggestions from Marta review accepted Co-authored-by: martab1994 <93210545+martab1994@users.noreply.github.com>

content/hardware/05.pro-solutions/solutions-and-kits/edge-control/tutorials/smart-irrigation-system/content.md

@@ -262,7 +262,7 @@ void loop() {
 
  // Different button taps handler
  switch (buttonStatus) {
- case ZERO_TAP: // will execute always the button is not being pressed.
+ case ZERO_TAP: // will execute always when the button is not being pressed.
  if (controlLCD == 1 && showTimeLCD == 0) {
  ValvesStatusLCD(); // when there is not an active timer
  controlLCD = 0;
@@ -315,7 +315,7 @@ void loop() {
  break;
  }
 
- // reset the valves accumuldated on time every day at midnight
+ // reset the valves' accumulated active time every day at midnight
  if (getLocalhour() == " 00:00:00") {
  Serial.println("Resetting accumulators every day");
  vals.z1_on_time = 0;
@@ -347,19 +347,19 @@ void loop() {
 
 The MKR WiFi 1010 needs the following libraries:
 
-- `ArduinoIoTCloud.h` It handles the Arduino IoT Cloud connection and project variables publishing. It can be installed directly from the Arduino Library Manager.
-- `Arduino_ConnectionHandler.h` It manages the Wi-Fi® connection and can be installed directly from the Arduino Library Manager.
-- `ArduinoJson.h` and `Arduino_JSON` These libraries parse and create JSON structures for the HTTP requests. They can be installed directly from the Arduino Library Manager.
-- `ArduinoHttpClient.h` This library requests weather data from the Open Weather API. It can be installed directly from the Arduino Library Manager.
-- `Wire.h` will enable the I2C communication between the Edge Control, the MKR WiFi 1010 and the other peripherals, it's included in the BSP of the MKR WiFi board.
-- `utility/wifi_drv.h` This library controls the MKR built-in RGB LED. It's included in the BSP of the MKR WiFi 1010.
+- `ArduinoIoTCloud.h` handles the Arduino IoT Cloud connection and project variables publishing. It can be installed directly from the Arduino Library Manager.
+- `Arduino_ConnectionHandler.h` manages the Wi-Fi® connection and can be installed directly from the Arduino Library Manager.
+- `ArduinoJson.h` and `Arduino_JSON` parse and create JSON structures for the HTTP requests. They can be installed directly from the Arduino Library Manager.
+- `ArduinoHttpClient.h` requests weather data from the Open Weather API. It can be installed directly from the Arduino Library Manager.
+- `Wire.h` will enable the I2C communication between the Edge Control, the MKR WiFi 1010 and the other peripherals. It is included in the BSP of the MKR WiFi board.
+- `utility/wifi_drv.h` controls the MKR built-in RGB LED. It is included in the BSP of the MKR WiFi 1010.
 
 There are two headers included in the project code that handles some helper functions and structures:
 
-- `thingProperties.h` This is automatically generated by the Arduino IoT Cloud, however, if you are using an offline IDE verify it's in the same directory as your sketch, it includes all the Arduino IoT Cloud variables.
+- `thingProperties.h` is automatically generated by the Arduino IoT Cloud. However, if you are using an offline IDE, verify it is in the same directory as your sketch and includes all the Arduino IoT Cloud variables.
 - `SensorValues.hpp` handles the shared variables between the Edge Control and the MKR WiFi 1010 through I2C.
 
-In the global variables, we define the MKR board I2C address (it must be the same as defined in the Edge Control code); we also define the water tank dimensions.
+In the global variables, the MKR board I2C address is defined. It must be the same as defined in the Edge Control code. In addition, the water tank dimensions are also set up.
 
 ```arduino
 #include "thingProperties.h"
@@ -395,11 +395,11 @@ String city = "Santiago de los Caballeros";
 String countryCode = "DO";
 ```
 
-The MKR WiFi 1010 will update its connection with the Arduino IoT Cloud, and check for changes on every variable, from the valves switches to the scheduled activated timers. It shows when it's successfully connected to the cloud by turning on its blue LED. Also, it asks for a weather forecast every 10 minutes to update the temperature, humidity and rain probability in the Arduino IoT Cloud dashboard.
+The MKR WiFi 1010 communicates with the Arduino IoT Cloud and checks for changes on every variable, from the valves switches to the scheduled activated timers. The board turns its LED blue when it is successfully connected to the cloud. Also, it asks for a weather forecast every 10 minutes to update the temperature, humidity and rain probability in the Arduino IoT Cloud dashboard.
 
 ```arduino
 void loop() {
- // function that ask for schedule timers set on the Cloud
+ // function that asks for timers scheduled on the Cloud
  scheduleHandler();
 
  unsigned long currentMillis = millis();
@@ -416,7 +416,7 @@ void loop() {
  }
  }
 
- // doing this just once after there's a WiFi connections
+ // doing this just once when a WiFi connection is established
  if (bootForecast == 1 && WiFi.status() == WL_CONNECTED) {
  getForecast(); // request rain probability
  getWeather(); // request temperature and humidity
@@ -437,7 +437,7 @@ void loop() {
 }
 ```
 
-The system needs to be as fast as possible when a valve activation is requested, this is why there is one function for each valve that is fired once the valve status is changed on the Arduino IoT Cloud.
+The system needs to be as fast as possible when a valve activation is requested. For this reason, each valve has its own function that is called once the valve status changes on the Arduino IoT Cloud.
 
 ```arduino
 /*
@@ -453,33 +453,32 @@ void onZ1Change() {
 }
 ```
 
-The `uploadValues(SensorValues_t *vals)` is executed every time the Edge Control requests data through I2C from the MKR. It updates all the local and cloud-shared variables to be sent, it also converts the water level variable to water volume using the cylinder volume formula:
+The `uploadValues(SensorValues_t *vals)` is executed every time the Edge Control requests data to the MKR through I2C communication. It updates all the local and cloud-shared variables to be sent and converts the water level variable to water volume applying the cylinder volume formula:
 
 `v = πr²h`
 
  Where:
  * `r` is the tank radius in meters.
  * `h` is the tank height in meters.
 
- As `r` and `h` are in meters, the volume result will be in cubic meters (m³), for a more intuitive perception of water quantity we will convert it to liters:
+ As `r` and `h` are in meters, the volume result will be in cubic meters (m³). For a more intuitive perception of water quantity, the volume can be converted into liters:
 
 `1m³ = 1000 L`
 
-As our level sensor output is in centimeters we can convert (height) to meters dividing by 100:`h = (water_level/100)`
+Since the level sensor output is in centimeters, it can be converted (height) into meters by dividing by 100:`h = (water_level/100)`
 
-To turn m³ into liters we just need to multiply by 1000: `water_volume = PI*(radius)*(radius)*(water_level/100)*1000`
+To turn m³ into liters, multiply by 1000: `water_volume = PI*(radius)*(radius)*(water_level/100)*1000`
 
-This is the brief why of the expression used in the code.
 
-Using flow control variables we store the initial water level as a reference point. Any level measured below that point will be considered as water used updating the `water_usage` variable. If we refill the tank, it will save the higher value of water level as a new reference point.
+To evaluate water consumption, the initial water level is stored as a reference point. Any level measured below that point will be considered as consumed water, updating the `water_usage` variable. If the tank is refilled, the new water level will become the new reference point.
 
 ```arduino
  water_level = vals->water_level_local;
  water_volume = PI * (radius) * (radius) * ((int)water_level/100) * 1000;
 
  if (waterCtrl == 0) {
  currentWater = water_volume;
- Serial.println("Initial Water Volumen: ");
+ Serial.println("Initial Water Volume: ");
  Serial.println(currentWater);
  water_usage = 0;
  waterCtrl = 1;
@@ -495,15 +494,20 @@ Using flow control variables we store the initial water level as a reference poi
 
 ### The Arduino IoT Cloud Dashboard
 
-Taking advantage of the Arduino IoT Cloud, its possible to seamlessly integrate a simple but powerful dashboard to monitor and visualize the status of the system in real-time, resulting in a professional Human-Computer Interaction (HCI) as can be seen below:
+Taking advantage of the Arduino IoT Cloud, it is possible to seamlessly integrate a simple but powerful dashboard to monitor and visualize the status of the system from remote, resulting in a professional Human-Computer Interaction (HCI) as shown below:
 
 ![Arduino Cloud project dashboard ](assets/dashboard_16-9.png)
 
-Within the Arduino IoT Cloud's dashboard, the system variables can be monitored and controlled. There are temperature, humidity and rain probability gauges showing the current weather status and forecast, toggle switches to control each motorized valve accompanied by a scheduler widget to set automatic irrigation routines, also time series graphs showing the daily activated time of each valve. Finally, there are water supply monitoring widgets, one that shows the current water level in percentage from 0-100%, a water volume widget that shows the remaining liters of water in the tank, and a water usage widget that shows the liters used daily.
+Within the Arduino IoT Cloud's dashboard, the system variables can be monitored and controlled as follow:
+- Temperature, humidity and rain probability are displayed in gauges, showing the current weather status and forecast.
+- Each motorized valve can be toggled through a dedicated switch accompanied by a scheduler widget to set automatic irrigation routines.
+- Each valve activated time is shown in a time series chart. 
+- Water consumption can be monitored in dedicated widgets: one that shows the current water level in percentage from 0-100%, a water volume widget that shows the remaining liters of water in the tank and a water usage widget that shows the daily consumed liters.
+
 
 ![Arduino Cloud project dashboard on a smartphone](assets/dashboard-cel.png)
 
-The dashboard can be easily accessible from a PC, mobile phone or tablet from anywhere, receiving an instantaneous update wherever we are.
+The dashboard is easily accessible from a browser, mobile phone or tablet, allowing a user to receive an instantaneous update on the irrigation status from anywhere.
 
 ## Full Smart Irrigation System Example
 
@@ -530,6 +534,6 @@ Thanks to the Edge Control capabilities to connect to the cloud and be remotely
 
 ### Next Steps
 
-As you already know how to develop a Smart Irrigation System with Arduino Edge Control and the MKR WiFi 1010, it's time for you to continue exploring all the capabilities of the Arduino Pro environment to integrate it with your professional setup and improve it with powerful solutions.
+Since you already know how to develop a Smart Irrigation System with Arduino Edge Control and the MKR WiFi 1010, it is time for you to continue exploring all the capabilities of the Arduino Pro portfolio and integrating it in your professional setup.
 
-You can add different connectivity modules like LoRaWAN®, GSM, RS-485 or Ethernet by using the [Arduino MKR family](https://store-usa.arduino.cc/collections/mkr-family)
+You can extend the capabilities of your Edge Control-based system by adding different connectivity options, leveraging the [Arduino MKR family](https://store-usa.arduino.cc/collections/mkr-family) like LoRaWAN®, GSM, RS-485 or Ethernet.