From 2f1a061f0d2be45c04fe6dcb27bf60fd4642cb71 Mon Sep 17 00:00:00 2001
From: Melvin Keskin <melvo@olomono.de>
Date: Sun, 17 Mar 2019 11:41:45 +0100
Subject: [PATCH] improve section "Use Cases"

---
 inbox/automatic-trust-transfer.xml | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/inbox/automatic-trust-transfer.xml b/inbox/automatic-trust-transfer.xml
index cda615e3..b0ce34f3 100644
--- a/inbox/automatic-trust-transfer.xml
+++ b/inbox/automatic-trust-transfer.xml
@@ -204,7 +204,7 @@
 		Alice would like to use OMEMO when communicating with Bob.
 		Alice has the devices A1, A2 and A3.
 		Bob has the device B1.
-		A1 has already authenticated the key of A2.
+		A1 has already authenticated A2's key.
 		The other devices have not authenticated each other's key.
 	</p>
 	<p>
@@ -214,7 +214,7 @@
 		<section3 topic='Sending' anchor='usecases-authentication-contact-device-sending'>
 			<p>
 				Example:
-				A1 authenticates the key of B1.
+				A1 authenticates B1's key.
 			</p>
 			<p>
 				A device that manually authenticates the key of a contact's device MUST send an authentication message for
@@ -265,7 +265,7 @@
 				</li>
 			</ol>
 			<p>
-				MUST authenticate the key as soon as the key of the device which sent the authentication message is authenticated by the receiving device.
+				MUST authenticate the key as soon as the receiving device authenticated the key of the device which sent the authentication message.
 			</p>
 		</section3>
 	</section2>
@@ -273,7 +273,8 @@
 		<section3 topic='Sending' anchor='usecases-authentication-own-device-sending'>
 			<p>
 				Example:
-				A1 authenticates the key of A3.
+				A2 has already authenticated A1's and B1's key.
+				A2 authenticates A3's key.
 			</p>
 			<p>
 				A device that manually authenticates the key of an own device MUST send an authentication message for
@@ -285,7 +286,7 @@
 					</p>
 					<p>
 						Example:
-						A1 sends an authentication message for A3's key to A2 and B1.
+						A2 sends an authentication message for A3's key to A1 and B1.
 					</p>
 				</li>
 				<li>
@@ -294,18 +295,18 @@
 					</p>
 					<p>
 						Example:
-						A1 sends an authentication message for A2's and B1's key to A3.
+						A2 sends an authentication message for A1's and B1's key to A3.
 					</p>
 				</li>
 			</ol>
 		</section3>
 		<section3 topic='Receiving' anchor='usecases-authentication-own-device-receiving'>
 			<p>
-				A device that receives an authentication message for a key of an own device from another own device MUST authenticate the key as soon as the key of the device that sent the authentication message is authenticated by the receiving device.
+				A device that receives an authentication message for a key of an own device from another own device MUST authenticate the key as soon as the receiving device authenticated the key of the device which sent the authentication message.
 			</p>
 			<p>
 				Example:
-				A2 authenticates A3's key by the authentication message from A1 as soon as A2 authenticated A1's key.
+				A1 authenticates A3's key by the authentication message from A2 as soon as A1 authenticated A2's key.
 			</p>
 		</section3>
 	</section2>