ui/sendviewcontroller.md

@@ -27,7 +27,36 @@ the state after composing is one of the following:
 
 ## internal states
 
-### security
+### recipientSecurityState`
+
+Recipients colored in blue symbolize we have a key for them.
+Recipients colored in orange symbolize we have no key for them.
+
+*  `none`
+     there are no recipients in the current composition
+*  `allSecure`
+     we have a key for every recipient of the current composition
+*  `allInsecure`
+     for none of the recipients we have a key
+*  `mixed`
+     we have a key for some recipients, but not for all
+
+### `mailSecurityState`
+
+Describes the security state of the composition itself.
+
+*  `letter`
+     send an encrypted and signed mail to every recipient
+     `recipientSecurityState` is `none` or `allSecure`
+*  `postcard`
+     A postcard symbolizes an unencrypted and unsigned mail.
+     If `enforcePostcard` is `false` (default) a letter is send to every recipient we have a key for instead of a postcard. Otherwise every recipient will get a postcard.
+*  `extendedPostcard`
+     same as postcard, but with extra features:
+     -  censored
+        every recipient, who gets a postcard, will get a censored postcard. This means the user may mark some parts of the body text to be only readable for letter recipients and visibly unreadable for postcard recipients.
+    -  partiallyEncrypted
+       same as censored, but the marked parts are readable for postcard recipients on a website with a password. The sender is guided to transfer the password over a second channel
 
 *  Letter
    -  we have a key for every recipient and no downgrade is enforced
@@ -46,12 +75,6 @@ the state after composing is one of the following:
 *  send in progress
    -  the client tries to send a mail at the moment. In this case we don't want the user to manipulate content or tap again on send
 
-## equivalent states
-
-*  invite mail
-   -  equal to downgraded postcard/letter with a special input + missing ability to open a new invite mail
-*  warning-reaction mail 
-   -  equal to a letter with special input
 
 
 ## important functions