dok

confluence/Package_Deployment_Guide.md

@@ -1341,7 +1341,12 @@ SET PAUSE OFF
 PROMPT =========================================================================
 PROMPT MARS-XXXX: Rollback Package
 PROMPT =========================================================================
-PROMPT WARNING: This will reverse all changes from MARS-XXXX installation!
+PROMPT This will reverse all changes from MARS-XXXX installation
+PROMPT
+PROMPT Rollback steps:
+PROMPT 1. Restore previous package version
+PROMPT 2. Remove added columns/tables
+PROMPT 3. Revert configuration changes
 PROMPT =========================================================================
 
 -- Confirm rollback with user
@@ -1375,6 +1380,32 @@ spool off
 - Revert configuration changes
 - Include verification step after rollback (@@verify_packages_version.sql)
 
+**Rollback Communication Style:**
+- ✅ **DO**: Use calm, professional tone describing what will be done
+- ✅ **DO**: List specific rollback steps clearly
+- ❌ **DON'T**: Use dramatic words like "WARNING", "CRITICAL IMPACT", "DANGER"
+- ❌ **DON'T**: Create panic - rollback is a normal part of deployment process
+- **Rationale**: Rollbacks happen when installations fail or need to be reversed. This is a standard procedure, not an emergency.
+
+**Example - Professional vs. Dramatic:**
+
+```sql
+-- ✅ CORRECT - Professional and Clear
+PROMPT This will reverse all changes from MARS-828 installation
+PROMPT
+PROMPT Rollback steps:
+PROMPT 1. Remove validation trigger
+PROMPT 2. Drop ARCHIVAL_STRATEGY and MINIMUM_AGE_MONTHS columns
+PROMPT 3. Restore FILE_ARCHIVER package to v2.0.0
+
+-- ❌ WRONG - Unnecessarily Dramatic
+PROMPT WARNING: This will restore FILE_ARCHIVER to v2.0.0
+PROMPT 
+PROMPT CRITICAL IMPACT:
+PROMPT 1. All archival strategies revert to THRESHOLD_BASED
+PROMPT 2. ARCHIVAL_STRATEGY and MINIMUM_AGE_MONTHS columns will be dropped
+```
+
 ---
 
 ### Version Tracking Integration