docs: Improve self-heal and auto-sync behaviors explanation for multi…

…-source apps (argoproj#20809) In single-source apps self-heal disabled guarantees that with no source changes the live changes won't get overridden. That's no longer the case for multi-source apps, since one of the sources changing can trigger a sync of everything. Add a note explaining this behavior. Signed-off-by: Andrii Korotkov <[email protected]>
andrii-korotkov-verkada · Nov 16, 2024 · 2c8b470 · 2c8b470
1 parent 0f872f5
commit 2c8b470
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/docs/user-guide/auto_sync.md b/docs/user-guide/auto_sync.md
@@ -75,6 +75,10 @@ spec:
       selfHeal: true
 ```
 
+NOTE: Disabling self-heal doesn't guarantee that live cluster changes won't be reverted for multi-source apps even if the
+resource's source didn't change, since other source may change and trigger autosync. Disable autosync if needed to
+handle these cases.
+
 ## Automated Sync Semantics
 
 * An automated sync will only be performed if the application is OutOfSync. Applications in a