summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2007-10-24 23:59:25 +0200
committerJonas Smedegaard <dr@jones.dk>2007-10-24 23:59:25 +0200
commitbbba24575445e04a1580191a53edee3113c11a65 (patch)
tree173a706c666dee7f5a3ea2ad1acdf8f2517a686a
parent8f6dd8985f908201b7fa18eba348748a1b97a086 (diff)
Lots of various improvements all over (from homebase.dk branch).
-rw-r--r--account.mdwn29
-rw-r--r--account/commands.mdwn2
-rw-r--r--index.mdwn4
-rw-r--r--internet.mdwn2
-rw-r--r--intro/email.mdwn30
-rw-r--r--intro/sms.mdwn1
-rw-r--r--mail.mdwn9
-rw-r--r--mail/intro.mdwn8
-rw-r--r--mail/setup.mdwn74
9 files changed, 71 insertions, 88 deletions
diff --git a/account.mdwn b/account.mdwn
index 15975ed..41c1315 100644
--- a/account.mdwn
+++ b/account.mdwn
@@ -1,30 +1,33 @@
# Accounts
-Each user has a single, password-protected account.
+Each user has a single, personal account.
+The account, and what it provides access to, is protected by a personal [[password]].
-## Optional personal resources
-Each account can have various resources attached:
+## Personal resources
- * [[mail/addresses]]
+Each account can have various personal resources attached:
+
+ * Email [[addresses]]
+ * Personal [[file_shares|files]]
* A personal [[homepage]]
* One or more [[websites]]
-## Accessible shared services
+## Shared services
-User accounts provide access to various services:
+User accounts provide access to various shared resources:
- * [[mailinglists]]
- * [[files]]
- * [[printers]]
- * [[addressbooks]]
- * [[calendars]]
+ * [[Mailinglists]]
+ * Collaborative [[file_shares|files]]
+ * [[Printers]]
+ * [[Addressbooks|addressbooks]]
+ * [[Calendars]]
## Account administration
-User accounts are administered by the technical supporters using a small set of [[commands]]
+User accounts are administered by the technical supporters using a small set of [[account/commands]]
-An [[introemail]] points new users to the [[intro]] on this documentation website.
+New users are pointed to the [[intro]] page by [[intro/email]] and [[intro/sms]].
diff --git a/account/commands.mdwn b/account/commands.mdwn
index 7a575df..c02c482 100644
--- a/account/commands.mdwn
+++ b/account/commands.mdwn
@@ -92,4 +92,4 @@ TODO: Rewrite as automated syslog-ng plugin or cron script passing the message t
### Locate users with short password lifespan
- (group=<gruppe>; echo $group:; for user in `members $group`; do chage -l $user|egrep -q '^Maximum:[[:blank:]]*[0-9]{2}$' && printf $user'\t' && chage -l $user|egrep '^Password Expires:'; done)
+ (group=<gruppe>; echo $group:; for user in `members $group`; do chage -l $user|egrep -q '^Maximum:\[[:blank:]]*[0-9]{2}$' && printf $user'\t' && chage -l $user|egrep '^Password Expires:'; done)
diff --git a/index.mdwn b/index.mdwn
index c9d72e1..f7f6a2d 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -1,4 +1,6 @@
-This is ICT documentation for a [[Redpill]] organisation.
+# ICT documentation.
+
+This is ICT documentation for this system - a [[Redpill]] organisation.
Please go read the [[intro]].
diff --git a/internet.mdwn b/internet.mdwn
index 35a2673..5e7d72f 100644
--- a/internet.mdwn
+++ b/internet.mdwn
@@ -1 +1,3 @@
+# Internet
+
Internet is but a set of communication rules for computers, allowing them to uniformly exchange information.
diff --git a/intro/email.mdwn b/intro/email.mdwn
index d901116..0a5b150 100644
--- a/intro/email.mdwn
+++ b/intro/email.mdwn
@@ -1,28 +1,22 @@
-
- Hi XXXXX!
+ Hi <fullname>
A personal account has been added for you at your host system.
- Your username is "XXX". Password will be sent through cellphone text message.
-
- NB! Password lasts only 14 days - read below how to change it!
+ Your username is "<username>". Password will be sent through cellphone text message.
The account is used for email addresses and other personal services. Currently
- the following email addresses has been attached:
- XXX@example.com
- XXXXX@another.example.com
+ the following email address(es) has been attached:
+ <addresses>
+
+ NB! Password lasts only 14 days - read here how to change it:
- Summary of configuration:
- * Your password is personal: Don't write it down, and don't reveal it to
- your boos or to technicians! If you forget it, you simply get another :-)
- * Email server is "mail.example.com" offering web, smtp, imap and pop3.
- * You MUST use SSL and password for all email service (also smtp).
-
- More on setup and possibilities with your new account - changing password,
- more email adresses, subscribing to mailinglists etc. - is here:
- http://support.redpill.dk/intro
+ http://support.redpill.dk/intro
+
+ Same place you can also read about setup and possibilities with your account
+ - more email adresses, subscribing to mailinglists etc.
Kind regards,
- XXXXX
+
+ <me>
Technical supporter
diff --git a/intro/sms.mdwn b/intro/sms.mdwn
index 4bc487d..4bb1d12 100644
--- a/intro/sms.mdwn
+++ b/intro/sms.mdwn
@@ -1,2 +1 @@
-
Here is a temporary password for your account. You MUST change it within 14 days: Read the web page http://support.redpill.dk/intro . Password: <password>
diff --git a/mail.mdwn b/mail.mdwn
index 2e583ab..00b1904 100644
--- a/mail.mdwn
+++ b/mail.mdwn
@@ -5,9 +5,14 @@ Each user [[account]] is an email account - with one ore more email [[addresses]
The [[intro]] quickly gets you started, while [[setup]] steps through the details.
+## Setup
+
+ * Short [[mail/intro]] to start using email
+ * [[Configuration|mail/setup]] more detailed
+
+
## Use
- * It is generally recommended to use imap instead of pop3
* Dealing with disk [[quota]]
- * Subscribing and posting to [[mailinglists]]
+ * Subscribing to and and using [[mailinglists]]
* [[Problem]] reporting
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):