docs(deploy): standardize installation and uninstallation terminology in README files (#168)

* docs(deploy): standardize installation and uninstallation terminology in README files

- update terminology for installation and uninstallation processes
- clarify cleanup and destroy definitions
- improve consistency in documentation language

📝 - Generated by Copilot

* docs(deploy): standardize cleanup and destruction terminology in README

- clarify cleanup steps for cluster components
- update descriptions for destroying infrastructure

🗑️ - Generated by Copilot

* docs(deploy): update destruction steps in README for clarity

- specify order of destroying VPN and remaining infrastructure
- improve instructions for resource group deletion

🔧 - Generated by Copilot

* docs(deploy): remove reference to terminology glossary in deployment description

🔒 - Generated by Copilot

Author: nguyena2

deploy/001-iac/README.md

@@ -4,7 +4,7 @@ Terraform configuration for the robotics reference architecture. Deploys Azure r
 
 ## 📋 Prerequisites
 
-| Tool         | Version         | Installation                    |
+| Tool         | Version         | Setup or Check                  |
 |--------------|-----------------|---------------------------------|
 | Azure CLI    | Latest          | `az login`                      |
 | Terraform    | 1.5+            | `terraform version`             |
@@ -322,7 +322,7 @@ az group delete --name <resource-group-name> --yes --no-wait
 
 ## 🔍 Troubleshooting
 
-Issues and resolutions encountered during infrastructure deployment and teardown.
+Issues and resolutions encountered during infrastructure deployment and destroy.
 
 ### Destroy Takes a Long Time
 

deploy/002-setup/README.md

@@ -330,7 +330,7 @@ kubectl describe sa osmo-service -n osmo-control-plane
 ├── 02-deploy-azureml-extension.sh
 ├── 03-deploy-osmo-control-plane.sh
 ├── 04-deploy-osmo-backend.sh
-├── cleanup/                    # Uninstall scripts
+├── cleanup/                    # Cleanup scripts
 ├── config/                     # OSMO configuration templates
 ├── lib/                        # Shared functions
 ├── manifests/                  # Kubernetes manifests
@@ -343,12 +343,12 @@ kubectl describe sa osmo-service -n osmo-control-plane
 | Script                                    | Purpose                      |
 |-------------------------------------------|------------------------------|
 | `optional/deploy-volcano-scheduler.sh`    | Volcano (alternative to KAI) |
-| `optional/uninstall-volcano-scheduler.sh` | Remove Volcano scheduler     |
+| `optional/uninstall-volcano-scheduler.sh` | Uninstall Volcano scheduler  |
 | `optional/add-user-to-platform.sh`        | Add user to OSMO platform    |
 
 ## 🗑️ Cleanup
 
-Uninstall scripts in `cleanup/` remove cluster components in reverse deployment order.
+Cleanup scripts in `cleanup/` uninstall cluster components in reverse deployment order.
 
 ### Cleanup Scripts
 
@@ -359,9 +359,9 @@ Uninstall scripts in `cleanup/` remove cluster components in reverse deployment
 | `cleanup/uninstall-azureml-extension.sh`  | ML extension, compute target, FICs    |
 | `cleanup/uninstall-robotics-charts.sh`    | GPU Operator, KAI Scheduler           |
 
-### Uninstall Order
+### Cleanup Order
 
-Run scripts in this order to avoid dependency issues:
+Run uninstall scripts in this order to avoid dependency issues:
 
 ```bash
 cd cleanup
@@ -394,7 +394,7 @@ By default, uninstall scripts preserve data. Use flags for complete removal:
 
 ### Full Component Cleanup
 
-Remove everything including data:
+Clean up everything including data:
 
 ```bash
 cd cleanup
@@ -406,7 +406,7 @@ cd cleanup
 
 ### Selective Cleanup
 
-Remove only specific components:
+Clean up only specific components:
 
 ```bash
 # OSMO only (preserve AzureML and GPU infrastructure)

deploy/README.md

@@ -2,6 +2,18 @@
 
 Infrastructure deployment and cluster configuration for the robotics reference architecture.
 
+## 📖 Terminology Glossary
+
+| Term | Definition |
+| --- | --- |
+| Deploy | Provision Azure infrastructure or install cluster components using Terraform or deployment scripts. |
+| Setup | Post-deploy configuration and access steps for the cluster and workloads. |
+| Install | Install local client tools or CLIs (for example, Azure VPN Client). |
+| Cleanup | Remove cluster components while keeping Azure infrastructure intact. |
+| Uninstall | Run uninstall scripts that remove deployed cluster components. |
+| Destroy | Delete Azure infrastructure (Terraform destroy or resource group deletion). |
+| Teardown | Avoid in docs; use Destroy for infrastructure removal. |
+
 ## 📋 Deployment Order
 
 | Step | Folder                                  | Description                                              | Time      |
@@ -83,17 +95,15 @@ See the [root README](../README.md) for architecture details.
 
 ## 🗑️ Cleanup
 
-Remove deployed components in reverse order. Cluster components must be removed before infrastructure.
+Remove deployed cluster components. Use [Destroy Infrastructure](#destroy-infrastructure) for VPN and Terraform removal.
 
-| Step | Folder                                  | Description                                   | Time      |
-|:----:|-----------------------------------------|-----------------------------------------------|-----------|
-|  1   | [002-setup/cleanup](002-setup/cleanup/) | Uninstall Helm charts, extensions, namespaces | 10-15 min |
-|  2   | [001-iac/vpn](001-iac/vpn/)             | Destroy VPN Gateway                           | 10-15 min |
-|  3   | [001-iac](001-iac/)                     | Terraform destroy or resource group deletion  | 20-30 min |
+| Folder                                  | Description                                   | Time      |
+|-----------------------------------------|-----------------------------------------------|-----------|
+| [002-setup/cleanup](002-setup/cleanup/) | Uninstall Helm charts, extensions, namespaces | 10-15 min |
 
-### Partial Cleanup (Cluster Components Only)
+### Cleanup Steps (Cluster Components)
 
-Remove OSMO, AzureML, and GPU components while preserving Azure infrastructure:
+Clean up OSMO, AzureML, and GPU components while preserving Azure infrastructure:
 
 ```bash
 cd 002-setup/cleanup
@@ -107,26 +117,27 @@ cd 002-setup/cleanup
 
 See [002-setup/README.md](002-setup/README.md#cleanup) for script options and data preservation.
 
-### Full Teardown
+### Destroy Infrastructure
 
-Remove all Azure resources. Choose based on how infrastructure was created.
+Destroy all Azure resources after cleanup. This removes VPN and Terraform-managed infrastructure.
 
 **Option A: Terraform Destroy** (recommended if using Terraform state)
 
 ```bash
-# Remove cluster components first
+# Clean up cluster components first
 cd 002-setup/cleanup
 ./uninstall-osmo-backend.sh --delete-container
 ./uninstall-osmo-control-plane.sh --purge-postgres --purge-redis --delete-mek
 ./uninstall-azureml-extension.sh
 ./uninstall-robotics-charts.sh --delete-namespaces --delete-crds
 
-# Destroy infrastructure
-cd ../../001-iac
+# Destroy VPN first (if deployed)
+cd ../../001-iac/vpn
 terraform destroy -var-file=terraform.tfvars
 
-# Optional: destroy VPN if deployed
-cd vpn && terraform destroy -var-file=terraform.tfvars
+# Destroy remaining infrastructure
+cd ..
+terraform destroy -var-file=terraform.tfvars
 ```
 
 **Option B: Delete Resource Group** (fastest, deletes everything)