restructured reducer documentation

1 files changed, 39 insertions, 63 deletions

diff --git a/anastasis.rst b/anastasis.rst
index c312a048..22e66d1c 100644
--- a/anastasis.rst
+++ b/anastasis.rst
@@ -899,7 +899,29 @@ Backup Reducer
 
 The illustration above shows the different states the reducer can have during a backup
 process.
-In the following, the individual transitions in the backup process will be specified in more detail.
+
+
+Recovery Reducer
+^^^^^^^^^^^^^^^^
+.. figure:: anastasis_reducer_recovery.png
+    :name: fig-anastasis_reducer_recovery
+    :alt: fig-anastasis_reducer_recovery
+    :scale: 35 %
+    :align: center
+
+    Recovery states and their transitions.
+
+
+The illustration above shows the different states the reducer can have during a recovery
+process.
+
+
+Reducer transitions
+^^^^^^^^^^^^^^^^^^^
+In the following, the individual transitions will be specified in more detail.
+
+Common transitions
+""""""""""""""""""
 
 **select_continent:**
 
@@ -910,6 +932,12 @@ Arguments (example):
       "continent": "Europe"
     }
 
+Expected new state:
+::
+
+    {
+    
+    }
 
 **select_country:**
 
@@ -939,6 +967,14 @@ Arguments (example):
     }
 
 
+**next**, **back**, **pay:**
+
+No Arguments needed.
+
+
+Backup transitions
+""""""""""""""""""
+
 **add_authentication:**
 
 Arguments (example):
@@ -1009,63 +1045,8 @@ Arguments (example):
 - type: *data* (secret must be a Crockford-Base32 encoded string of some data, e.g. a private key)
 
 
-**next**, **back**, **pay:**
-
-No Arguments needed.
-
-
-Recovery Reducer
-^^^^^^^^^^^^^^^^
-.. figure:: anastasis_reducer_recovery.png
-    :name: fig-anastasis_reducer_recovery
-    :alt: fig-anastasis_reducer_recovery
-    :scale: 35 %
-    :align: center
-
-    Recovery states and their transitions.
-
-
-The illustration above shows the different states the reducer can have during a recovery
-process.
-In the following, the individual transitions in the backup process will be specified in more detail.
-
-**select_continent:**
-
-Arguments (example):
-::
-
-    {
-      "continent": "Europe"
-    }
-
-
-**select_country:**
-
-Arguments (example):
-::
-
-    {
-      "country": "Germany",
-      "country_code": "de",
-      "currency": "EUR"
-    }
-
-
-**enter_user_attributes:**
-
-Arguments (example):
-::
-
-    {
-      "identity_attributes": {
-        "full_name": "Max Musterman",
-        "social_security_number": "123456789",
-        "birth_year": "2000",
-        "birth_month": "01",
-        "birth_day": "01"
-      }
-    }
-
+Recovery transitions
+""""""""""""""""""""
 
 **select_challenge:**
 
@@ -1088,11 +1069,6 @@ Arguments (example):
     }
 
 
-**back**, **pay:**
-
-No Arguments needed.
-
-
 .. _anastasis-auth-methods:
 
 ----------------------