Update README and changelog with targeted deletion + ADX limitation

- Fix quick-start examples: ADX requires -Force, storage-only example added
- Update Remove-FinOpsTestData section with targeted folder deletion
- Add ADX limitation warning to README
- Update changelog entry to describe targeted deletion accurately

Author: Zach Olinske

docs-mslearn/toolkit/changelog.md

@@ -44,7 +44,7 @@ The following section lists features and enhancements that are currently in deve
 
 - **Added**
   - Added [New-FinOpsTestData](powershell/data/New-FinOpsTestData.md) to generate synthetic, multi-cloud FOCUS-compliant cost data for Azure, AWS, GCP, and on-premises providers. Supports FOCUS versions 1.0-1.3 with version-specific column sets, commitment discounts, Azure Hybrid Benefit, tag variation, and inline budget scaling. Includes `-Seed` for reproducibility and upload to Azure storage. Generated manifests include a `_ftkTestData` watermark for safe cleanup identification.
-  - Added [Remove-FinOpsTestData](powershell/data/Remove-FinOpsTestData.md) to purge test data from Azure Data Explorer tables, storage containers, and local test-data folders for a clean reset. Includes multi-layer safety features: local-only cleanup by default, storage marker verification (checks for `_ftkTestData` in manifests before deleting), and ADX cleanup requires `-Force`. Supports optional ADF trigger management and ADX update policy verification.
+  - Added [Remove-FinOpsTestData](powershell/data/Remove-FinOpsTestData.md) to purge test data from Azure Data Explorer tables, storage containers, and local test-data folders for a clean reset. Includes multi-layer safety features: local-only cleanup by default, targeted storage deletion (scans manifests for `_ftkTestData` marker and removes only test-data folders — production data is preserved), and ADX cleanup requires `-Force` because `.clear table` removes all rows. Supports optional ADF trigger management and ADX update policy verification.
 
 <br>
 

src/templates/finops-hub/test/README.md

@@ -30,11 +30,11 @@ New-FinOpsTestData -FocusVersion 1.0 -ServiceProvider Azure -RowCount 50000
 # Generate and upload to Azure Storage with ADF trigger management
 New-FinOpsTestData -StorageAccountName "stfinopshub" -ResourceGroupName "rg-finopshub" -AdfName "adf-finopshub" -StartTriggers
 
-# Remove all test data (ADX tables, storage blobs, local files) for a clean reset
-Remove-FinOpsTestData -AdxClusterUri "https://mycluster.region.kusto.windows.net" -StorageAccountName "stfinopshub"
+# Remove test-data folders from storage (production data is preserved)
+Remove-FinOpsTestData -StorageAccountName "stfinopshub"
 
-# Full cleanup with ADF trigger management
-Remove-FinOpsTestData -AdxClusterUri "https://mycluster.region.kusto.windows.net" -StorageAccountName "stfinopshub" -AdfName "adf-finopshub" -ResourceGroupName "rg-finopshub" -StopTriggers
+# Full cleanup including ADX (requires -Force because .clear table removes ALL rows)
+Remove-FinOpsTestData -AdxClusterUri "https://mycluster.region.kusto.windows.net" -StorageAccountName "stfinopshub" -AdfName "adf-finopshub" -ResourceGroupName "rg-finopshub" -StopTriggers -Force
 ```
 
 ### Features
@@ -80,14 +80,18 @@ Plus FinOps Hub-specific `x_` prefixed extension columns for dashboard compatibi
 
 ### Remove-FinOpsTestData (Clean Reset)
 
-The `Remove-FinOpsTestData` command performs a full cleanup for re-testing:
+The `Remove-FinOpsTestData` command performs a targeted cleanup for re-testing:
 
 1. **Stops ADF triggers** (optional, with `-StopTriggers -AdfName -ResourceGroupName`) to prevent re-ingestion during cleanup
-2. **Purges all ADX tables** in both Hub and Ingestion databases via REST API
+2. **Purges all ADX tables** in both Hub and Ingestion databases via REST API (requires `-Force`)
 3. **Verifies ADX update policies** are intact after clearing tables
-4. **Deletes all blobs** from `msexports` and `ingestion` storage containers
+4. **Deletes test-data folders from storage** — scans manifests for `_ftkTestData` marker and removes only marked folders (production data is preserved)
 5. **Removes local test-data folder**
 
-Requires `-AdxClusterUri` and `-StorageAccountName`. Uses `ConfirmImpact = 'High'` so PowerShell will prompt for confirmation unless `-Confirm:$false` is passed.
+All cloud parameters are optional. By default only local files are deleted. Pass `-StorageAccountName` for storage cleanup and `-AdxClusterUri -Force` for ADX cleanup.
+
+> **Important:** Do not ingest test data into an ADX cluster that also contains production data. Storage cleanup is targeted (only test-data folders are removed), but ADX `.clear table` removes **all** rows. If you accidentally mix test and production data in ADX, clear the tables and re-ingest production data from storage.
+
+Uses `ConfirmImpact = 'High'` so PowerShell will prompt for confirmation unless `-Confirm:$false` is passed.
 
 Run `Get-Help Remove-FinOpsTestData -Detailed` for the full parameter reference.