diff docs/troubles-handling.rst @ 5495:d3cf24afa620

unstable-list: add cause-of-trouble section for phase-divergence

--- a/docs/troubles-handling.rst	Wed Aug 26 11:51:14 2020 +0200
+++ b/docs/troubles-handling.rst	Mon Aug 17 16:52:26 2020 +0530
@@ -176,6 +176,13 @@
 Cause of trouble
 ****************
 
+It can appear if a user locally change the phase of an obsolete changeset
+(which has successors) to public.
+
+Phase-divergence can also happens when the users rewrite draft changeset that got
+published in another repository. The phase divergence then "discovered" when the
+publishing information of the predecessors is pulled in the local repository.
+
 Source of Complexity
 ********************