diff --git a/README.md b/README.md
index 486a5d8..e740fd8 100644
--- a/README.md
+++ b/README.md
@@ -1158,7 +1158,7 @@ Python uses snake_case (e.g. `target_memory_utilization`, `scale_down_cooldown_s
 |---|---|---|
 | `type` | string | Metric source type. Built-in: `CPU`, `Memory`, `NetworkIngress`, `NetworkEgress`. External: `prometheus` |
 | `targetUtilization` | string | Target utilization as a decimal string (resource metrics). Example: `"0.70"` |
-| `targetValue` | string | Absolute target value as a string (external/object metrics). Example: `"50"` (50 MB/s of network throughput) |
+| `targetValue` | string | Absolute target value as a string (external/object metrics). Example: `"50"` (e.g. 50 req/s) |
 | `weight` | string | Weight for composite formula scaling (decimal string). Example: `"0.5"` |
 | `metadata` | map[string]string | Free-form key-value pairs passed to the external scaler |
 | `serverAddress` | string | Prometheus server URL — packed into `metadata` by the service layer. Example: `"http://prometheus:9090"` |
@@ -1186,7 +1186,7 @@ const rule = new resources.WorkloadRule("my-app-rule", {
         metrics: [
             {
                 type: "prometheus",                            // external Prometheus metric
-                targetValue: "50",                       // absolute target value (e.g. 50 MB/s of network throughput)
+                targetValue: "50",                             // absolute target value (e.g. 50 req/s)
                 serverAddress: "http://prometheus:9090",       // Prometheus server URL
                 query: "sum(rate(http_requests_total[2m]))",   // PromQL query
             },
diff --git a/sdk/go/devzero/README.md b/sdk/go/devzero/README.md
index 486a5d8..e740fd8 100644
--- a/sdk/go/devzero/README.md
+++ b/sdk/go/devzero/README.md
@@ -1158,7 +1158,7 @@ Python uses snake_case (e.g. `target_memory_utilization`, `scale_down_cooldown_s
 |---|---|---|
 | `type` | string | Metric source type. Built-in: `CPU`, `Memory`, `NetworkIngress`, `NetworkEgress`. External: `prometheus` |
 | `targetUtilization` | string | Target utilization as a decimal string (resource metrics). Example: `"0.70"` |
-| `targetValue` | string | Absolute target value as a string (external/object metrics). Example: `"50"` (50 MB/s of network throughput) |
+| `targetValue` | string | Absolute target value as a string (external/object metrics). Example: `"50"` (e.g. 50 req/s) |
 | `weight` | string | Weight for composite formula scaling (decimal string). Example: `"0.5"` |
 | `metadata` | map[string]string | Free-form key-value pairs passed to the external scaler |
 | `serverAddress` | string | Prometheus server URL — packed into `metadata` by the service layer. Example: `"http://prometheus:9090"` |
@@ -1186,7 +1186,7 @@ const rule = new resources.WorkloadRule("my-app-rule", {
         metrics: [
             {
                 type: "prometheus",                            // external Prometheus metric
-                targetValue: "50",                       // absolute target value (e.g. 50 MB/s of network throughput)
+                targetValue: "50",                             // absolute target value (e.g. 50 req/s)
                 serverAddress: "http://prometheus:9090",       // Prometheus server URL
                 query: "sum(rate(http_requests_total[2m]))",   // PromQL query
             },
diff --git a/sdk/nodejs/README.md b/sdk/nodejs/README.md
index 486a5d8..e740fd8 100644
--- a/sdk/nodejs/README.md
+++ b/sdk/nodejs/README.md
@@ -1158,7 +1158,7 @@ Python uses snake_case (e.g. `target_memory_utilization`, `scale_down_cooldown_s
 |---|---|---|
 | `type` | string | Metric source type. Built-in: `CPU`, `Memory`, `NetworkIngress`, `NetworkEgress`. External: `prometheus` |
 | `targetUtilization` | string | Target utilization as a decimal string (resource metrics). Example: `"0.70"` |
-| `targetValue` | string | Absolute target value as a string (external/object metrics). Example: `"50"` (50 MB/s of network throughput) |
+| `targetValue` | string | Absolute target value as a string (external/object metrics). Example: `"50"` (e.g. 50 req/s) |
 | `weight` | string | Weight for composite formula scaling (decimal string). Example: `"0.5"` |
 | `metadata` | map[string]string | Free-form key-value pairs passed to the external scaler |
 | `serverAddress` | string | Prometheus server URL — packed into `metadata` by the service layer. Example: `"http://prometheus:9090"` |
@@ -1186,7 +1186,7 @@ const rule = new resources.WorkloadRule("my-app-rule", {
         metrics: [
             {
                 type: "prometheus",                            // external Prometheus metric
-                targetValue: "50",                       // absolute target value (e.g. 50 MB/s of network throughput)
+                targetValue: "50",                             // absolute target value (e.g. 50 req/s)
                 serverAddress: "http://prometheus:9090",       // Prometheus server URL
                 query: "sum(rate(http_requests_total[2m]))",   // PromQL query
             },
diff --git a/sdk/python/README.md b/sdk/python/README.md
index 486a5d8..e740fd8 100644
--- a/sdk/python/README.md
+++ b/sdk/python/README.md
@@ -1158,7 +1158,7 @@ Python uses snake_case (e.g. `target_memory_utilization`, `scale_down_cooldown_s
 |---|---|---|
 | `type` | string | Metric source type. Built-in: `CPU`, `Memory`, `NetworkIngress`, `NetworkEgress`. External: `prometheus` |
 | `targetUtilization` | string | Target utilization as a decimal string (resource metrics). Example: `"0.70"` |
-| `targetValue` | string | Absolute target value as a string (external/object metrics). Example: `"50"` (50 MB/s of network throughput) |
+| `targetValue` | string | Absolute target value as a string (external/object metrics). Example: `"50"` (e.g. 50 req/s) |
 | `weight` | string | Weight for composite formula scaling (decimal string). Example: `"0.5"` |
 | `metadata` | map[string]string | Free-form key-value pairs passed to the external scaler |
 | `serverAddress` | string | Prometheus server URL — packed into `metadata` by the service layer. Example: `"http://prometheus:9090"` |
@@ -1186,7 +1186,7 @@ const rule = new resources.WorkloadRule("my-app-rule", {
         metrics: [
             {
                 type: "prometheus",                            // external Prometheus metric
-                targetValue: "50",                       // absolute target value (e.g. 50 MB/s of network throughput)
+                targetValue: "50",                             // absolute target value (e.g. 50 req/s)
                 serverAddress: "http://prometheus:9090",       // Prometheus server URL
                 query: "sum(rate(http_requests_total[2m]))",   // PromQL query
             },