Merge pull request #466 from arduino/cloud-agent-improvements

Cloud agent improvements [HC-1472]

Author: Renat0Ribeir0

content/Arduino Cloud/Cloud Editor/If-the-Arduino-Cloud-Agent-isnt-detected.md

@@ -3,30 +3,34 @@ title: "If the Arduino Cloud Agent isn't detected"
 id: 360016466600
 ---
 
-Learn what to do if the Arduino Cloud Agent isn't detected by the [Arduino Cloud](https://cloud.arduino.cc/).
+If the Arduino Cloud Agent isn't detected by the [Arduino Cloud](https://cloud.arduino.cc/), you may encounter one of the following warnings:
 
-If you haven't done so, [install the Arduino Cloud Agent](https://create.arduino.cc/getting-started/plugin/welcome). If you still encounter one of the warnings bellow, follow the [troubleshooting steps](#troubleshooting).
+* `No Cloud Agent Connection`
+* `To upload a Sketch via USB port, make sure the Cloud Agent is installed and running on this computer.`
+* `Latest Arduino Cloud Agent required`
+* `To use Arduino Cloud effectively, you need to install the latest Arduino Cloud Agent. This ensures your device is discoverable and allows you to upload sketches.`
 
-* `Arduino Cloud Agent not found`
-* `To upload a sketch via USB port, make sure the Agent is installed and running on this computer`
+To resolve this issue, follow the [troubleshooting steps](#troubleshooting) below.
 
 ---
 
 <a id="troubleshooting"></a>
 
 ## Troubleshooting
 
-1. Check if the [Arduino Cloud Agent is running](https://support.arduino.cc/hc/en-us/articles/4980687506844), since sometimes it may be **off** or **paused**.
+1. **Install the Arduino Cloud Agent:**  If you haven't already done so, [install the Arduino Cloud Agent](https://create.arduino.cc/getting-started/plugin/welcome). If the Cloud Agent is still not detected, follow the next troubleshooting steps.
 
-2. If you are using [Brave Browser](https://brave.com/), see [Use Arduino Cloud with Brave Browser](https://support.arduino.cc/hc/en-us/articles/10482021304988-Use-Arduino-Cloud-with-Brave-Browser).
+2. **Ensure the Arduino Cloud Agent is Running:** Check if the [Arduino Cloud Agent is running](https://support.arduino.cc/hc/en-us/articles/4980687506844), as it may be *off* or *paused*.
 
-3. **If you're using Safari on macOS:** Check if the HTTPS certificate for Safari has been installed:
+3. **Brave Browser Users:** If you are using [Brave Browser](https://brave.com/), see [Use Arduino Cloud with Brave Browser](https://support.arduino.cc/hc/en-us/articles/10482021304988-Use-Arduino-Cloud-with-Brave-Browser) for specific instructions.
+
+4. **Safari on macOS Users:** Ensure the HTTPS certificate for Safari is installed:
     1. Open the Arduino Cloud Agent menu (Look for the ![Arduino Cloud Agent icon](img/cloud-agent-logo-mac.png) icon in the top-right of the menu bar of macOS).
-    2. Click on the **Manage HTTPS certificate** menu and make sure that the certificate is installed and trusted.  
+    2. Click on the *Manage HTTPS certificate* menu and make sure that the certificate is installed and trusted.  
        If it’s not, you can click on the button "Install the certificate for Safari".
     3. Enter the administrative credentials, if prompted.
     4. Refresh the Safari browser window.
 
-4. If you're using the [Cloud Agent on a Mac computer with an Apple Silicon processor](https://github.com/arduino/arduino-create-agent#apple-m1-support) (e.g. Apple M1 chip), make sure to [install Rosetta 2](https://support.apple.com/en-us/HT211861).
+5. **Mac Computers with Apple Silicon (e.g., M1 chip):** Ensure you have [installed Rosetta 2](https://support.apple.com/en-us/HT211861).
 
-If you are still having issues, [uninstall the Arduino Cloud Agent](https://support.arduino.cc/hc/en-us/articles/360014869840) and [reinstall it](https://create.arduino.cc/getting-started/plugin/welcome).
+If you are still experiencing issues, [uninstall the Arduino Cloud Agent](https://support.arduino.cc/hc/en-us/articles/360014869840) and then [reinstall it](https://create.arduino.cc/getting-started/plugin/welcome).

content/Arduino Cloud/General Cloud/Check-if-the-Arduino-Cloud-Agent-is-installed-and-running.md

@@ -7,23 +7,25 @@ Learn how to check if the **Arduino Cloud Agent** is installed and running on yo
 
 ---
 
-1. _Make sure the agent is not paused._ Look for the ![Arduino Cloud Agent icon](img/cloud-agent-logo-mac.png) icon in the top-right of the menu bar (macOS and Linux) or bottom-right of the taskbar (Windows), usually within the system tray:
+1. **Find and start the Cloud Agent:** Try searching for "Arduino Cloud Agent" or looking for it in your application menu. Alternatively, use the system's file browser and look in the default installation paths:
 
-   ![The Cloud Agent in the system tray on Windows.](img/cloud-agent-system-tray.png)
+   * *Windows:* `C:\Users\{username}\AppData\Roaming\ArduinoCloudAgent\Arduino_Cloud_Agent.exe`
 
-   If you find it, click it. If a _Resume Agent_ option is available, the agent is currently paused. Click _Resume Agent_ to resume.
+   * *macOS:* `/Applications/ArduinoCloudAgent.app` [^1]
 
-2. _Find and start the application_. Try searching for "Arduino Cloud Agent" or looking for it in your application menu. Alternatively, use the system's file browser and look in the default installation paths:
+   * *Linux* `home/{username}/ArduinoCloudAgent/ArduinoCloudAgent`
 
-   * **Windows:** `C:\Users\{username}\AppData\Roaming\ArduinoCloudAgent\Arduino_Cloud_Agent.exe`
+   If you **can't find the application**, follow the [online installation guide](https://create.arduino.cc/getting-started/plugin/welcome) to install the agent.
 
-   * **macOS:** `/Applications/ArduinoCloudAgent.app` [^1]
+2. **Make sure the Cloud Agent is running:**
 
-   * **Linux** `home/{username}/ArduinoCloudAgent/ArduinoCloudAgent`
+   * **Find the Cloud Agent icon:**  Look for the ![Arduino Cloud Agent icon](img/cloud-agent-logo-mac.png) icon. On *macOS* and *Linux*, it is located in the top-right corner of the menu bar. On *Windows*, you will find it in the bottom-right corner of the taskbar, usually within the system tray.
 
-3. _Install or reinstall the agent._ If you can't find the application, follow the [online installation guide](https://create.arduino.cc/getting-started/plugin/welcome) to install the agent.
+     ![The Cloud Agent in the system tray on Windows.](img/cloud-agent-system-tray.png)
 
-[^1]: Older versions of the agent can be found at:
+   * **Resume if paused:** Click the ![Arduino Cloud Agent icon](img/cloud-agent-logo-mac.png) icon to open the menu. If you see the option _Resume Agent_, it indicates the agent is paused. Click _Resume Agent_ to resume.
+
+[^1]: In macOS, older versions of the agent can be found at:
 
       * `/Applications/ArduinoCreateAgent.app`
       * `Users/{username}/Applications/ArduinoCreateAgent`