3 files changed, 91 insertions, 0 deletions
diff --git a/doc/intro.md b/doc/intro.md
new file mode 100644
index 0000000..19d6240
--- /dev/null
+++ b/doc/intro.md
@@ -0,0 +1,17 @@
+# Introduction to disk quota
+
+Your account has limited disk space. All of your personal files and emails have
+a sharing maximum.
+
+You will automatically receive email warnings if you reach your "quota" limit.
+You will then need to delete either some of your personal files or some of your
+emails.
+
+/!\ If you ignore quota warnings, then your account will be locked, and all
+emails sent to you will be rejected!
+
+
+## More info
+
+ * [[Use|quota/use]] of disk quota - eg. hints to freeing disk space
+ * [[Configuration|quota/setup]] to continuously show current disk quota status
diff --git a/doc/setup.md b/doc/setup.md
new file mode 100644
index 0000000..2997cc3
--- /dev/null
+++ b/doc/setup.md
@@ -0,0 +1,28 @@
+# Setting up disk quota
+
+Your account has limited disk space. You will automatically receive warnings if
+you reach your "quota" limit.
+
+/!\ If you fail keep your account below your quota limit, then after some days
+your account will be locked. This affects several services, e.g. all emails
+sent to you will be rejected!
+
+## Disk quota status
+
+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. 
+
+### IMP webmail
+
+  1. Enter "Layout" in the top panel to the right
+  2. Select "Account information" and choose "Add"
+  3. Select "Save"
+
+
+## More info
+
+ * [[Use|quota/use]] of disk quota - eg. hints to freeing disk space
diff --git a/doc/use.md b/doc/use.md
new file mode 100644
index 0000000..b0f7df6
--- /dev/null
+++ b/doc/use.md
@@ -0,0 +1,46 @@
+# Disk quota usage
+
+Your account has limited disk space. All of your personal files and emails have
+a shard maximum.
+
+Your use of disk space is monitored, and if you use more space than allowed,
+you will automatically receive warnings to free some space: Either delet some
+of your personal files or some of your emails.
+
+/!\ If you fail to free enough disk space to get you below your quota limit,
+then after some days your account will be locked. This affects several
+services, e.g. all emails sent to you will be rejected!
+
+
+## Files
+
+If you use some of your personal [[file_shares|files]], then they probably
+consume more space than your emails: Sound, graphics and multimedia files
+are much larger than simple text messages like emails.
+
+## Emails
+
+Consider deleting emails with big attachments. Save the attachements as plain
+files first, if you want them preserved: email attachments consume up to the
+double amount of that used by same documents stored normally.
+
+If you use Apple Mail, your emails may fill up space on the server even when
+deleted in the application. See [[email_setup|mail/setup]] for more about the
+problem. To immediately purge deleted emails, do this:
+
+ 1. Open Apple Mail
+ 2. Go to Preferences > Accounts > Advanced
+ 3. Click the button 'Remove Now'. 
+
+When you use imap (you probably do), then some routines may not behave as you
+would expect:
+
+ * You may have more folders on the server than shown in your email program.
+   You need to "subscribe" to additional email folders to see them.
+ * It is not enough to "delete" emails. You need to also "purge" the deleted
+   emails to have them completely removed from the system.
+
+
+## More info
+
+ * [[Configuration|quota/setup]] to continuously show current disk quota status