service/schleuder.md

@@ -2,7 +2,7 @@
 
 Schleuder is a gpg-enabled mailing list manager with resending-capabilities. Subscribers can communicate encrypted (and pseudonymously) among themselves, receive emails from non-subscribers and send emails to non-subscribers via the list.
 
-For more details see https://schleuder.nadir.org/docs/.
+For more details see https://schleuder.org/schleuder/docs/index.html.
 
 Schleuder runs on [Eugeni](https://db.torproject.org/machines.cgi?host=eugeni). The version of Schleuder currently installed is: 3.1.2
 
@@ -42,6 +42,8 @@ And then:
 
 ## Administration of lists
 
+There are two ways to administer schleuder lists: through the CLI interface of the schleuder API daemon, or by sending PGP encrypted emails with the appropriate commands to `listname-request@withtheemail.org`.
+
 ### Pre-requisites
 
 #### Daemon
@@ -60,6 +62,12 @@ The `schleuder-cli` program should be executed in the context of the `torschleud
 
 For this to work, your user account must be a member of the `torschleuder` group.
 
+#### PGP
+
+For administration through the `listname-request` email interface, you will need the ability to encrypt and sign messages with PGP. This can be done through your email client, or with `gpg` on the command line with the armored block them copied into a plaintext email.
+
+All email commands must be PGP encrypted with the public key of the mailing list in question. Please follow the instructions above for obtaining that mailing list's key.
+
 ### List creation
 
 To create a list you can:
@@ -74,6 +82,7 @@ To export a list public key you can do the following:
 
 ### Subscriptions management
 
+##### CLI daemon
 Subscription are managed with the subscriptions command.
 
 To subscribe a new user to a list do:
@@ -88,9 +97,41 @@ To designate (or undesignate) a list admin:
 
     sudo -u torschleuder schleuder-cli subscriptions set secret-team@lists.torproject.org person@torproject.org admin true
 
-Lists can also be administered via email commands sent to `secret-team-request@lists.torproject.org` (list name followed by `-request`).
+##### Email commands
+
+Lists can also be administered via email commands sent to `listname-request@lists.torproject.org` (list name followed by `-request`). Available commands are described in the [Schleuder documentation for list-admins](https://schleuder.org/schleuder/docs/list-admins.html).
+
+To subscribe a new user, you should first add their PGP key. To do this, send the following email to `listname-request@lists.torproject.org`, encrypted with the public key of the mailing list and signed with your own PGP key:
+
+```
+x-listname listname@lists.torproject.org
+x-add-key
+-----BEGIN PGP PUBLIC KEY BLOCK-----
+-----END PGP PUBLIC KEY BLOCK-----
+```
+
+You should receive a confirmation email similar to the following that the key was successfully added:
+```
+This key was newly added:
+0x1234567890ABCDEF1234567890ABCDEF12345678 user@domain.tld 1970-01-01 [expires: 2080-01-01]
+```
+
+After adding the key, you can subscribe the user by sending the following (signed and encrypted) email to `listname-request@lists.torproject.org`:
+
+```
+x-listname listname@lists.torproject.org
+x-subscribe user@domain.tld 0x1234567890ABCDEF1234567890ABCDEF12345678
+```
+
+You should receive a confirmation email similar to the following:
+
+```
+user@domain.tld has been subscribed with these attributes:
 
-Available commands are described in the [Schleuder documentation for list-admins](https://schleuder.org/schleuder/docs/list-admins.html).
+Fingerprint: 1234567890ABCDEF1234567890ABCDEF12345678
+Admin? false
+Email-delivery enabled? true
+```
 
 ### Other commands