Merge pull request #103023 from gwynnemonahan/OSDOCS-17449

OSDOCS-17449 [NETOBSERV] Module short descriptions for netobserv_cli

Author: JoeAldinger

modules/network-observability-cli-capturing-flows.adoc

@@ -6,7 +6,10 @@
 [id="network-observability-cli-capturing-flows_{context}"]
 = Capturing flows
 
-You can capture flows and filter on any resource or zone in the data to solve use cases, such as displaying Round-Trip Time (RTT) between two zones. Table visualization in the CLI provides viewing and flow search capabilities.
+[role="_abstract"]
+Capture network flows and apply filters based on resources or zones directly in the CLI. This helps you solve complex use cases, such as visualizing the Round-Trip Time (RTT) between two different zones.
+
+Table visualization in the CLI provides viewing and flow search capabilities.
 
 .Prerequisites
 * Install the {oc-first}.
@@ -20,13 +23,13 @@ You can capture flows and filter on any resource or zone in the data to solve us
 $ oc netobserv flows --enable_filter=true --action=Accept --cidr=0.0.0.0/0 --protocol=TCP --port=49051
 ----
 . Add filters to the `live table filter` prompt in the terminal to further refine the incoming flows. For example:
-+ 
++
 [source,terminal]
 ----
 live table filter: [SrcK8S_Zone:us-west-1b] press enter to match multiple regular expressions at once
 ----
 . Use the *PageUp* and *PageDown* keys to toggle between *None*, *Resource*, *Zone*, *Host*, *Owner* and *all of the above*.
-. To stop capturing, press kbd:[Ctrl+C]. The data that was captured is written to two separate files in an `./output` directory located in the same path used to install the CLI. 
+. To stop capturing, press kbd:[Ctrl+C]. The data that was captured is written to two separate files in an `./output` directory located in the same path used to install the CLI.
 . View the captured data in the `./output/flow/<capture_date_time>.json` JSON file, which contains JSON arrays of the captured data.
 +
 .Example JSON file

modules/network-observability-cli-capturing-metrics.adoc

@@ -6,7 +6,8 @@
 [id="network-observability-cli-capturing-metrics_{context}"]
 = Capturing metrics
 
-You can generate on-demand dashboards in Prometheus by using a service monitor for network observability.
+[role="_abstract"]
+Generate on-demand network observability dashboards in Prometheus using a service monitor. This allows you to quickly view and analyze network metrics.
 
 .Prerequisites
 * Install the {oc-first}.

modules/network-observability-cli-capturing-packets.adoc

@@ -6,7 +6,8 @@
 [id="network-observability-cli-capturing-packets_{context}"]
 = Capturing packets
 
-You can capture packets using the Network Observability CLI.
+[role="_abstract"]
+Use the Network Observability CLI to capture network packets. You can apply filters and refine them live in the terminal for accurate, real-time debugging.
 
 .Prerequisites
 * Install the {oc-first}.

modules/network-observability-netobserv-cli-about.adoc

@@ -6,7 +6,10 @@
 [id="network-observability-netoberv-cli-about_{context}"]
 = About the Network Observability CLI
 
-You can quickly debug and troubleshoot networking issues by using the Network Observability CLI (`oc netobserv`). The Network Observability CLI is a flow and packet visualization tool that relies on eBPF agents to stream collected data to an ephemeral collector pod. It requires no persistent storage during the capture. After the run, the output is transferred to your local machine. This enables quick, live insight into packets and flow data without installing the Network Observability Operator.  
+[role="_abstract"]
+Use the Network Observability CLI (`oc netobserv`) to quickly debug and troubleshoot networking issues. This tool provides instant, live insight into flows and packets without installing the Network Observability Operator.
+
+The Network Observability CLI is a flow and packet visualization tool that relies on eBPF agents to stream collected data to an ephemeral collector pod. It requires no persistent storage during the capture. After the run, the output is transferred to your local machine.
 
 [IMPORTANT]
 ====

modules/network-observability-netobserv-cli-cleaning.adoc

@@ -6,9 +6,8 @@
 [id="network-observability-cli-uninstall_{context}"]
 = Cleaning the Network Observability CLI
 
-You can manually clean the CLI workload by running `oc netobserv cleanup`. This command removes all the CLI components from your cluster.
-
-When you end a capture, this command is run automatically by the client. You might be required to manually run it if you experience connectivity issues.
+[role="_abstract"]
+Use `oc netobserv cleanup` to manually remove all components installed by the Network Observability CLI from your cluster. While the client runs this command automatically after a capture, you may need to run it manually if you face connectivity issues.
 
 .Procedure
 * Run the following command: