Lots of various improvements all over (from homebase.dk branch).

2 files changed, 30 insertions, 52 deletions

diff --git a/mail/intro.mdwn b/mail/intro.mdwn
index 870368d..f4cd90c 100644
--- a/mail/intro.mdwn
+++ b/mail/intro.mdwn
@@ -11,7 +11,7 @@ All incoming emails are stored in your account inbox, no matter what email addre
 
 (contact your technicians for the location of webmail at this system)
 
-This is ready to use as is - no special setup required.
+This is ready to use as is - no additional setup required to get started.
 
 
 ## Local email application
@@ -28,6 +28,6 @@ Here's a short summary of the needed setup:
 
 ## More info
 
-See [[setup]] for more details on setting up your computer to use your account at this system.
-
-See [[mail]] for an overview of info related to using email at this sysmte.
+ * [[Setup]] more detailed.
+ * [[Overview|mail]] of email-related info.
+ * [[Overview|account]] of uses of your account.
diff --git a/mail/setup.mdwn b/mail/setup.mdwn
index 55a9bf5..7abbf28 100644
--- a/mail/setup.mdwn
+++ b/mail/setup.mdwn
@@ -1,27 +1,26 @@
-Setting up your personal email account
-======================================
+# Setting up your personal email account
 
-As a user of this system you have been given a single "account". Tied to this account is an email address (or perhaps more than one, especially if you are related to several organisations at this system).
+As a user at this system you have been given a single [[account]]. Tied to this account is an email address (or possibly more than one).
 
-All incoming emails are stored in the inbox of your personal account.
+All incoming emails are delivered to the inbox of your personal account (ie. same location no matter if you have more addresses attached).
 
 
-Webmail setup
--------------
+## Webmail setup
 
 Webmail is probably the simplest way to reach your emails. Somewhat like HoTMaiL but without advertisements and with fewer spam mails.
 
-The webmail application "IMP" also gives access to change password for your account at this system.
+One common website (contact your technicians for its location) offers several webmail applications, each with different strengths and weaknesses.
+The topmost application, IMP, is recommended, due to its most complete functionality. It provides access to changing your account [[password|password.en]].
+Same website also lists some alternative websites also offering webmail access to Homebase accounts. Save those addresses on your own computer, for the case of the primary website one day being out of order.
 
-One common website (contact your technicians for its location) provides several webmail applications, each with different strengths and weaknesses. It also lists alternative websites also offering webmail access to accounts at this system.
+Entering webmail, step by step:
 
- * Go to the webmail website (contact your technicians for its location)
- * Pick the topmost webmail application, IMP.
- * Login using your personal username and password
+ 1. Go to the webmail website (contact your technicians for its location)
+ 2. Pick the topmost webmail application, IMP.
+ 3. Login using your personal username and password
 
 
-Recommended setup of local email program
-----------------------------------------
+## Recommended setup of local email program
 
 If you have a computer of your own, it is recommended to use a "real" email application instead webmail. It works faster and is more stable. It is also puts less burden on the server.
 
@@ -31,58 +30,37 @@ If you have a computer of your own, it is recommended to use a "real" email appl
 
  * Create an "imap" account.
 
-   (!) The alternative, pop3 (suggest by default in most applications), is less flexible - e.g. does not work well concurrently with webmail access to your emails.
+   (!) The alternative, pop3 (suggested by default in most applications), is less flexible - e.g. does not work well concurrently with webmail access to your emails.
 
  * Use your provided username, and the hostname provided by your technicians, as both incoming and outgoing server.
- * Enable encryption for incoming mail (either imap or pop3):
-  1. Enable "SSL" connection.
-
-     /!\ Avoid "TLS" (also called "secure ''passwords''") - it does not work together with SSL
-
+ * Enable encryption for incoming mail (imap or pop3):
+  1. Enable "SSL" connection (also called "secure connection")
  * Enable encryption for outgoing mail (smtp):
   1. Enable "SSL" connection.
-
-     /!\ Avoid "TLS" (also called "secure ''passwords''") - it does not work together with SSL
-
-  2. Change port number from the standard 25 to 465
+  2. Change port number from the standard 25 to 465 (Mozilla Thunderbird does this automatically)
   3. Enable authentication, using same username and password as for your incoming mail.
 
-When creating your account, you are usually guided by a "wizard". The wizard asks for the account type (imap or pop3), username and server names, but typically do not care about security. So most probably you will have to finish the wizard and afterwards go back into the detailed configuration setup and adjust to enable encryption.
-
-Disk quota
-----------
+    /!\ Avoid "TLS" (also called "secure ''passwords''") - it does not work together with SSL
 
-Your account has limited disk space. You will automatically receive warnings if you reach your "quota" limit.
+Many email applications help you setting up your account using a "wizard". Unfortunately such routines often ignores security aspects required at this system.
+So most probably you will have to first use the wizard and then manually enter "advanced settings" and enable some security options.
 
-/!\ If you ignore quota warnings, then your account will be locked, causing emails sent to you to be rejected!
+When you enable the improved security, the email application might complain that it does not trust the mail server.
+You then need to accept the "security certificate" used at this system (see external reference to riseup.net at the bottom of this page). This is not needed with Mozilla Thunderbird.
 
-Some imap email programs can be configured to show your current quota status:
 
- * Mozilla Thunderbird:
-  1. Install the [Display Quota](https://addons.mozilla.org/thunderbird/881/) plugin.
+## Special quirks with Apple Mail
 
- * IMP webmail:
-  1. Choose "Layout" in the top right corner
-  2. Select "Account information" and choose "Add"
-  3. Select "Save"
+The default setting for some versions of Apple Mail is to leave a copy of all your emails on the server, even deleted ones.
 
-For info on freeing space to get below the quota limit, see ItDiskQuota.
-
-Special quirks with Apple Mail
-------------------------------
-
-You have to take some precautions when using Apple Mail as your mail reader.
-
-If you chose pop3 as mail protocol (or if you didn't choose at all - pop3 is suggested by default), then the default settings is to leave a copy of all emails on the server, also deleted ones.
-
-To avoid filling up the allowed disk space on your account (your "quota") you will need to change that behaviour:
+If you use Apple Mail, you need to avoid filling up your [[allowed disk space|quota/intro.en]] by changing that behaviour:
 
  1. Open Mail
  2. Go to Preferences > Accounts > Advanced
  3. Check √ 'remove copy from server after retrieving a message'
 
-External links
---------------
+
+## External links
 
 Help texts at riseup.net (whenever "mail.riseup.net" is mentioned, use the mailserver hostname of this system instead):