diff --git a/docs/source/dev/README.rst b/docs/source/dev/README.rst
index 19940b80b6d2341a012876411589c15f6668e371..f9d10518ac9c352186e894ef8e439b19f7ca3878 100644
--- a/docs/source/dev/README.rst
+++ b/docs/source/dev/README.rst
@@ -139,12 +139,15 @@ Storage-Time Spending (ie Use)
    participant StorageNode as "Storage Node"
    participant SpendingService as "Spending Service"
 
-   MagicFolder -> TahoeLAFS : store some data
+   [-> MagicFolder: upload triggered
    activate MagicFolder
 
-   TahoeLAFS -> ZKAPAuthorizer : store some data
+   MagicFolder -> TahoeLAFS : store some data
    activate TahoeLAFS
 
+   TahoeLAFS -> ZKAPAuthorizer : store some data
+   activate ZKAPAuthorizer
+
    loop until tokens accepted
        ZKAPAuthorizer <- ZKAPAuthzDB : load some tokens
        ZKAPAuthorizer -> StorageNode : store some data using these tokens
@@ -154,17 +157,18 @@ Storage-Time Spending (ie Use)
            SpendingService -> StorageNode: already spent, rejected
            StorageNode -> ZKAPAuthorizer: already spent, rejected
        else fresh tokens
-           SpendingService -> StorageNode: spent, allowed
-           StorageNode -> ZKAPAuthorizer: data stored
-           ZKAPAuthorizer -> ZKAPAuthzDB: discard spent tokens
+           SpendingService -> StorageNode: accepted
        end
-
-       ZKAPAuthorizer -> TahoeLAFS: data stored
-       deactivate TahoeLAFS
-       TahoeLAFS -> MagicFolder: data stored
-       deactivate MagicFolder
    end
 
+   StorageNode -> ZKAPAuthorizer: data stored
+   deactivate ZKAPAuthorizer
+   ZKAPAuthorizer -> ZKAPAuthzDB: discard spent tokens
+   ZKAPAuthorizer -> TahoeLAFS: data stored
+   deactivate TahoeLAFS
+   TahoeLAFS -> MagicFolder: data stored
+   deactivate MagicFolder
+
 .. include::
       ../../../morph/grid/local/README.rst