Merge pull request #21908 from ajpinedam/doc/update.networkactivity

docs: update network activity

Author: ajpinedam

doc/articles/features/windows-networking.md

@@ -5,72 +5,82 @@ uid: Uno.Features.WNetworking
 # Networking
 
 > [!TIP]
-> This article covers Uno-specific information for the `Windows.Networking` namespace. For a full description of the feature and instructions on using it, see [Windows.Networking Namespace](https://learn.microsoft.com/uwp/api/windows.networking).
+> This article provides specific information about Uno within the `Windows.Networking` namespace. For a comprehensive overview of the feature and guidance on how to use it, visit [Windows.Networking](https://learn.microsoft.com/uwp/api/windows.networking).
 
-* The `Windows.Networking` namespace provides classes for accessing and managing network connections from your app.
+The `Windows.Networking` namespace offers classes to access and manage network connections within your app.
 
-## Supported features
+## NetworkInformation
+
+The `Windows.Networking.Connectivity.NetworkInformation` class provides access to network connection information and allows you to monitor changes in network connectivity. For more details, refer to the official documentation: [NetworkInformation Class](https://learn.microsoft.com/uwp/api/windows.networking.connectivity.networkinformation).
+
+### Supported features
 
 | Feature                        | Windows | Android | iOS | Web (WASM) | macOS | Linux (Skia) | Win 7 (Skia) |
 |--------------------------------|---------|---------|-----|------------|-------|--------------|--------------|
 | `GetInternetConnectionProfile` | ✔       | ✔       | ✔   | ✔          | ✔     | ✔            | ✔            |
 | `NetworkStatusChanged`         | ✔       | ✔       | ✔   | ✔          | ✔     | ✔            | ✔            |
 
-## Checking Network Connectivity in Uno
+### Checking Network Connectivity in Uno
 
 For more detailed guidance on network connectivity, watch our video tutorial:
 
 > [!Video https://www.youtube-nocookie.com/embed/sK9IbkBAXIo]
 
-## Platform-specific
+### Platform-specific
 
-### Android
+#### Android
 
-Android can recognize all values of `NetworkConnectivityLevel`. iOS, macOS, and WASM return either `None` or `InternetAccess`.
+Android recognizes all values of the `NetworkConnectivityLevel` [enum](https://learn.microsoft.com/uwp/api/windows.networking.connectivity.networkconnectivitylevel). In contrast, iOS, macOS, and WASM only return either `None` or `InternetAccess`.
 
-The `android.permission.ACCESS_NETWORK_STATE` permission is required. It can be added to the application manifest or with the following attribute in the Android platform head:
+The `android.permission.ACCESS_NETWORK_STATE` permission is necessary and must be included in the application manifest or specified using the following attribute in the Android platform head:
 
 ```csharp
 [assembly: UsesPermission("android.permission.ACCESS_NETWORK_STATE")]
 ```
 
-### iOS/macOS reachability host name
+#### iOS/macOS reachability host name
+
+iOS and macOS use a 'ping' request to check internet connectivity. The default domain is `www.example.com`; however, you can change it to any other domain by setting the `WinRTFeatureConfiguration.NetworkInformation.ReachabilityHostname` property.
 
-On iOS and macOS, an actual 'ping' request is necessary to verify internet connectivity. The default domain that is checked is `www.example.com`, but you can change this to be any other domain by setting the `WinRTFeatureConfiguration.NetworkInformation.ReachabilityHostname` property.
+```csharp
+WinRTFeatureConfiguration.NetworkInformation.ReachabilityHostname = "platform.uno";
+```
 
-## Example
+### Example
 
-### Checking for internet connectivity
+#### Checking for internet connectivity
 
-You can use the following snippet to check for internet connectivity level in a cross-platform manner:
+Use the snippet below to check internet connectivity levels in a cross-platform manner.
 
 ```csharp
+using Windows.Networking.Connectivity;
+
 var profile = NetworkInformation.GetInternetConnectionProfile();
-if (profile == null)
-{
-    // No connection
-}
-else
+var level = profile?.GetNetworkConnectivityLevel();
+if (level is NetworkConnectivityLevel.InternetAccess)
 {
-    var level = profile.GetNetworkConnectivityLevel();
-    // level is a value of NetworkConnectivityLevel enum
+    // Connected to the internet
 }
 ```
 
-### Observing changes in connectivity
+#### Observing changes in connectivity
 
-You can use the following snippet to observe changes in connectivity:
+Use the following snippet to observe changes in connectivity:
 
 ```csharp
+using Windows.Networking.Connectivity;
+
 NetworkInformation.NetworkStatusChanged += NetworkInformation_NetworkStatusChanged;
 
 private void NetworkInformation_NetworkStatusChanged(object sender)
 {
-    // Your implementation here
+    // read the current connectivity state/level
+    var profile = NetworkInformation.GetInternetConnectionProfile();
+    var level = profile?.GetNetworkConnectivityLevel();
 }
 ```
 
-### Unsubscribing from the changes
+#### Unsubscribing from the changes
 
 ```csharp
 NetworkInformation.NetworkStatusChanged -= NetworkInformation_NetworkStatusChanged;