# HG changeset patch
# User Pierre-Yves David <pierre-yves.david@octobus.net>
# Date 1597421382 -7200
# Node ID 457d8003e84032f3f227806ac3d7df900a770f15
# Parent  e3302ad5ad77b56f0e5c2b8691faed64066da5db
unstable-list: add information about when/why orphan appears

(maybe a bit short?), but making the distinction between the local and remote
case seems useful.

diff -r e3302ad5ad77 -r 457d8003e840 docs/troubles-handling.rst
--- a/docs/troubles-handling.rst	Fri Aug 14 18:08:48 2020 +0200
+++ b/docs/troubles-handling.rst	Fri Aug 14 18:09:42 2020 +0200
@@ -33,6 +33,13 @@
 Cause of trouble
 ****************
 
+Orphan can appears because the use locally rewrite changeset with descendants.
+In this case the orphan are created when the command run.
+
+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.
+
 Source of Complexity
 ********************