[taler-docs] branch master updated: DD48: formatting, clarify transition

[gnunet]

This is an automated email from the git hooks/post-receive script.

dold pushed a commit to branch master
in repository docs.

The following commit(s) were added to refs/heads/master by this push:
     new dae5fc77 DD48: formatting, clarify transition
dae5fc77 is described below

commit dae5fc77d64ee72e83b52ced12e7f1d509a6a364
Author: Florian Dold <florian@dold.me>
AuthorDate: Wed Aug 30 11:36:59 2023 +0200

    DD48: formatting, clarify transition
---
 design-documents/048-wallet-exchange-lifecycle.rst | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/design-documents/048-wallet-exchange-lifecycle.rst 
b/design-documents/048-wallet-exchange-lifecycle.rst
index 259d9b6b..693d0145 100644
--- a/design-documents/048-wallet-exchange-lifecycle.rst
+++ b/design-documents/048-wallet-exchange-lifecycle.rst
@@ -39,12 +39,14 @@ Exchange Entry Status
 ---------------------
 
 The wallet exposes three separate status fields for each exchange entry:
+
 * the entry status
 * the update status
 * the ToS status
 
 
-entry status:
+Entry Status
+~~~~~~~~~~~~
 
 * ``preset``: Exchange record has been added to the exchange (typically as
   a hardcoded preset in wallet-core).  While the exchange can be selected for 
operations,
@@ -55,7 +57,14 @@ entry status:
   In this state, the exchange record will be garbage-collected eventually.
 * ``used``: The exchange is known and used, the wallet regularly queries /keys.
 
-update status:
+Transitions:
+
+* A transition from ``used`` to ``emphemeral`` is not possible,
+  since this would eventually remove preset exchanges and likely confuse
+  the user.
+
+Update Status
+~~~~~~~~~~~~~
 
 * ``initial``: Not updated, no need to update
 * ``initial(update)``: Update pending, possibly with error
@@ -67,7 +76,8 @@ update status:
 * ``ready``: Exchange is useable.
 * ``ready(update)``: Exchange is useable, but currently being updated.
 
-ToS status:
+ToS Status
+~~~~~~~~~~
 
 * ``pending``: The wallet is still trying to download the ToS.
   Possibly the last download attempt failed, will be reflected in an

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.