changeset 5483:e82d336bf31e

unstable-list: add an introduction text
author Pierre-Yves David <pierre-yves.david@octobus.net>
date Fri, 14 Aug 2020 17:59:51 +0200
parents 3435822cd758
children e3302ad5ad77
files docs/troubles-handling.rst
diffstat 1 files changed, 11 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- 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
 #########