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

…-source apps (#20809) (#20811) Closes #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]>
argoproj · Nov 18, 2024 · b391642 · b391642
1 parent c4f51c0
commit b391642
Showing 1 changed file with 2 additions and 0 deletions.
diff --git a/docs/user-guide/auto_sync.md b/docs/user-guide/auto_sync.md
@@ -75,6 +75,8 @@ spec:
       selfHeal: true
 ```
 
+Disabling self-heal does not guarantee that live cluster changes won't be reverted in multi-source applications. Even if a resource's source remains unchanged, changes in one of the sources can trigger `autosync`. To handle such cases, consider disabling `autosync`.
+
 ## Automated Sync Semantics
 
 * An automated sync will only be performed if the application is OutOfSync. Applications in a