changeset 5496:87aad54c0f1f

unstable-list: expand a bit the "cause of trouble" for phase divergence
author Pierre-Yves David <pierre-yves.david@octobus.net>
date Wed, 26 Aug 2020 11:55:19 +0200
parents d3cf24afa620
children e7b70fe1297a
files docs/troubles-handling.rst
diffstat 1 files changed, 3 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/docs/troubles-handling.rst	Mon Aug 17 16:52:26 2020 +0530
+++ b/docs/troubles-handling.rst	Wed Aug 26 11:55:19 2020 +0200
@@ -34,11 +34,13 @@
 ****************
 
 Orphan can appears because the user locally rewrite changeset with descendants.
-In this case the orphan are created when the command run.
+In this case the orphan are created when the command run. They are few real use
+case for such action and the user interface should focus on discouraging it.
 
 Orphan can also happens when the users created new changeset on draft that got
 rewritten in another repository. The orphan are then "discovered" when the
 obsolescence information of the ancestors is pulled in the local repository.
+This is the most common way to create phase divergences.
 
 Source of Complexity
 ********************