# HG changeset patch
# User Sushil khanchi <sushilkhanchi97@gmail.com>
# Date 1600762806 -19800
# Node ID f701c75e53f609ccff437909deae488bc4d53381
# Parent  1bc58c156c8926dca22b36ecbf6f32a87b6aabe3
unstable-list: add "finding the resolution parent" section

diff -r 1bc58c156c89 -r f701c75e53f6 docs/troubles-handling.rst
--- a/docs/troubles-handling.rst	Tue Sep 22 13:49:10 2020 +0530
+++ b/docs/troubles-handling.rst	Tue Sep 22 13:50:06 2020 +0530
@@ -281,3 +281,59 @@
 
 .. contents::
    :local:
+
+D-A: Finding the resolution parent
+----------------------------------
+
+This section is responsible to decide where the resultant changeset should live. If it's unable to
+find the resolution parent, we abort the content-divergence resolution. Following are the possible
+situations between the two divergent changesets and current support for each situation.
+
+D-A1: one of the divergent changeset is public
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Set the parent of public changeset as resolution parent.
+
+Note: After we resolve content-divergence in this case, the resultant changeset will be
+phase-divergent with the public side; so then we resolve phase-divergence to completely
+resolve the instability.
+
+D-A2: both are on the same parent
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Set the parent (or its successor, if apply) as resolution parent.
+
+D-A3: both are on different parents
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+D-A3.1: one side moved
+""""""""""""""""""""""
+
+Set the parent of moved changeset as resolution parent.
+
+D-A3.2: both moved forward; same branch
+"""""""""""""""""""""""""""""""""""""""
+
+Set the parent of ahead one as resolution parent.
+As most obvious is that, ahead one has the latest changes.
+
+D-A3.3: both moved backward; same branch
+""""""""""""""""""""""""""""""""""""""""
+
+XXX: yet to decide resolution
+
+D-A3.4: both moved opposite; same branch
+""""""""""""""""""""""""""""""""""""""""
+
+XXX: yet to decide resolution
+
+D-A3.5: both moved; one moved on different unrelated branch
+"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+
+XXX: yet to decide resolution
+
+D-A3.6: both moved on two different unrelated branch
+""""""""""""""""""""""""""""""""""""""""""""""""""""
+
+XXX: yet to decide resolution
+