# HG changeset patch
# User Pierre-Yves David <pierre-yves.david@octobus.net>
# Date 1597420791 -7200
# Node ID e82d336bf31e8377ffaa3f59d2311fa3c7d2bd7a
# Parent  3435822cd7580b62652f5511711a1cf67b7f189d
unstable-list: add an introduction text

diff -r 3435822cd758 -r e82d336bf31e docs/troubles-handling.rst
--- a/docs/troubles-handling.rst	Fri Aug 14 17:58:21 2020 +0200
+++ b/docs/troubles-handling.rst	Fri Aug 14 17:59:51 2020 +0200
@@ -5,6 +5,17 @@
 Possible troubles in rewriting history and their resolution
 -----------------------------------------------------------
 
+Rewriting history, and especially rewriting draft history that have been
+exchanged can lead to "unstable" situation.
+
+This document is intended for developer of the changeset evolution concept. It
+cover through the technical aspects of each "instability" a changeset can get
+into. A aims at building an exhaustive list of each cases and sub-cases and the
+status of automatic resolution for these cases.
+
+Public changeset are part of the permanent history and are never considered
+unstable.
+
 Orphan
 #########