update README

Signed-off-by: Arvind Thirumurugan <arvindth@microsoft.com>

Author: Arvind Thirumurugan

approval-controller-metric-collector/README.md

@@ -203,11 +203,15 @@ The script performs the following for each member cluster:
 4. Creates hub token secret with proper RBAC
 5. Installs the metric-collector via Helm
 
-The `metric-app:local` image is pre-loaded so it's available when you propagate the sample-metric-app deployment from hub to member clusters.
+The `metric-app:local` image is loaded so it's available when you propagate the sample-metric-app deployment from hub to member clusters.
 
 ### 8. Create Staged Update
 
-Switch back to hub cluster and create a staged update run:
+You can create staged updates using either cluster-scoped or namespace-scoped resources:
+
+#### Option A: Cluster-Scoped Staged Update (ClusterStagedUpdateRun)
+
+Switch back to hub cluster and create a cluster-scoped staged update run:
 
 ```bash
 # Switch to hub cluster
@@ -220,63 +224,156 @@ kubectl apply -f ./examples/updateRun/example-csus.yaml
 
 # Apply ClusterResourcePlacement
 kubectl apply -f ./examples/updateRun/example-crp.yaml
-```
 
-```bash
 # Verify CRP is created
 kubectl get crp -A
 ```
 
+Output:
 ```bash
 NAME              GEN   SCHEDULED   SCHEDULED-GEN   AVAILABLE   AVAILABLE-GEN   AGE
 example-crp       1     True        1                                           4s
-proemetheus-crp   1     True        1               True        1               3m1s
+prometheus-crp    1     True        1               True        1               3m1s
 ```
 
 ```bash
 # Apply ClusterStagedUpdateRun to start the staged rollout
 kubectl apply -f ./examples/updateRun/example-csur.yaml
 
-```bashubec
 # Check the staged update run status
 kubectl get csur -A
 ```
 
+Output:
 ```bash
 NAME                         PLACEMENT     RESOURCE-SNAPSHOT-INDEX   POLICY-SNAPSHOT-INDEX   INITIALIZED   PROGRESSING   SUCCEEDED   AGE
 example-cluster-staged-run   example-crp   0                         0                       True          True                      5s
 ```
 
+#### Option B: Namespace-Scoped Staged Update (StagedUpdateRun)
+
+Alternatively, you can use namespace-scoped resources:
+
+```bash
+# Switch to hub cluster
+kubectl config use-context kind-hub
+
+cd ../approval-request-controller
+```
+
+``` bash
+# Apply namespace-scoped ClusterResourcePlacement
+kubectl apply -f ./examples/updateRun/example-ns-only-crp.yaml
+
+kubectl get crp -A
+```
+
+Output:
+```bash
+NAME              GEN   SCHEDULED   SCHEDULED-GEN   AVAILABLE   AVAILABLE-GEN   AGE
+ns-only-crp       1     True        1               True        1               5s
+proemetheus-crp   1     True        1               True        1               2m34s
+```
+
+```bash
+# Apply StagedUpdateStrategy
+kubectl apply -f ./examples/updateRun/example-sus.yaml
+
+# Verify SUS is created
+kubectl get sus -A
+```
+
+Output:
+```bash
+NAMESPACE   NAME                      AGE
+test-ns     example-staged-strategy   4s
+```
+
+```bash
+# Apply ResourcePlacement
+kubectl apply -f ./examples/updateRun/example-rp.yaml
+
+# Verify RP is created
+kubectl get rp -A
+```
+
+Output:
+```bash
+NAMESPACE   NAME         GEN   SCHEDULED   SCHEDULED-GEN   AVAILABLE   AVAILABLE-GEN   AGE
+test-ns     example-rp   1     True        1                                           35s
+```
+
+```bash
+# Apply StagedUpdateRun to start the staged rollout
+kubectl apply -f ./examples/updateRun/example-sur.yaml
+
+# Check the staged update run status
+kubectl get sur -A
+```
+
+Output:
+```bash
+NAMESPACE   NAME                 PLACEMENT    RESOURCE-SNAPSHOT-INDEX   POLICY-SNAPSHOT-INDEX   INITIALIZED   PROGRESSING   SUCCEEDED   AGE
+test-ns     example-staged-run   example-rp   0                         0                       True          True                      5s
+```
+
 ### 9. Monitor the Staged Rollout
 
 Watch the staged update progress:
 
+#### For Cluster-Scoped Updates:
+
 ```bash
 # Check the staged update run status
 kubectl get csur -A
-```
 
-```bash
 # Check approval requests (should be auto-approved based on metrics)
 kubectl get clusterapprovalrequest -A
 ```
 
+Output:
 ```bash
 NAME                                       UPDATE-RUN                   STAGE     APPROVED   AGE
-example-cluster-staged-run-after-prod      example-cluster-staged-run   prod      True       2m9s
+example-cluster-staged-run-after-staging   example-cluster-staged-run   staging   True       2m9s
 ```
 
 ```bash
 # Check metric collector reports
 kubectl get metriccollectorreport -A
 ```
 
+Output:
 ```bash
 NAMESPACE                     NAME                                    WORKLOADS   LAST-COLLECTION   AGE
 fleet-member-kind-cluster-1   mc-example-cluster-staged-run-staging   1           27s               2m57s
 ```
 
-Eventually all the approval requests are approved for the updateRun.
+#### For Namespace-Scoped Updates:
+
+```bash
+# Check the staged update run status
+kubectl get sur -A
+
+# Check approval requests (should be auto-approved based on metrics)
+kubectl get approvalrequest -A
+```
+
+Output:
+```bash
+NAMESPACE   NAME                               UPDATE-RUN           STAGE     APPROVED   AGE
+test-ns     example-staged-run-after-staging   example-staged-run   staging   True       64s
+```
+
+```bash
+# Check metric collector reports
+kubectl get metriccollectorreport -A
+```
+
+Output:
+```bash
+NAMESPACE                     NAME                            WORKLOADS   LAST-COLLECTION   AGE
+fleet-member-kind-cluster-1   mc-example-staged-run-staging   1           27s               57s
+```
 
 The approval controller will automatically approve stages when the metric collectors report that workloads are healthy.
 1. Builds the `metric-collector:latest` image
@@ -319,20 +416,6 @@ kubectl config use-context kind-hub
 kubectl get metriccollectorreport -A
 ```
 
-### Monitor Staged Update Progress
-
-Watch the approval process:
-```bash
-# Watch staged update run status
-kubectl get csur -A -w
-
-# Check cluster approval requests
-kubectl get clusterapprovalrequest -A
-
-# View approval request details
-kubectl describe clusterapprovalrequest <approval-request-name>
-```
-
 ## Configuration
 
 ### Approval Request Controller