add wiki.md, email.md

wiki/source/Setting-up-email.md

@@ -1,11 +0,0 @@
----
-title: setting up email
----
-
-Your shiny, new tilde.club account comes with an email account you can use only between tilde.club members. `pine`  is a command-line email application to use it, as is `mutt`. Good old-fashioned `mail` works too, although it's a little cryptic.
-
-`pine` is menu driven, and the menus are self-explanatory; it's surprisingly easy to learn, and surprisingly powerful when you want to customize it.
-
-From the command line (after logged in via SSH), type: `pine` and `[return]`
-Follow instructions and use the menus at the bottom and top. (Note: When you see the ^ in front of the letter it means you need to use CTRL, otherwise just use the letter.)
-

wiki/source/email.md

@@ -1,12 +1,41 @@
 ---
-title: Setting up email
-author: vielmetti
+title: email
+author: benharri
 ---
 
-
-Your shiny, new tilde.club account comes with an email account you can use between tilde.club members as well as internet email. `alpine`  is a command-line email application to use it, as is `mutt`. Good old-fashioned `mail` works too, although it's a little cryptic.
+Your shiny, new tilde.club account comes with an email account. `alpine`  is a command-line email application to use it, as is `mutt`. Good old-fashioned `mail` works too, although it's a little cryptic.
 
 `alpine` is menu driven, and the menus are self-explanatory; it's surprisingly easy to learn, and surprisingly powerful when you want to customize it.
 
-From the command line (after logged in via SSH), type: `alpine` and `[return]`
+From the command line (after logged in via SSH), type: `pine` and `[return]`
 Follow instructions and use the menus at the bottom and top. (Note: When you see the ^ in front of the letter it means you need to use CTRL, otherwise just use the letter.)
+
+## non-cli options
+
+alternatively, you can use the [webmail](https://webmail.tilde.club/) or standard imap/smtp.
+
+some clients will automatically detect the right settings (tested with thunderbird).
+
+connection settings:
+- imap.tilde.club port 993 with ssl
+- pop3.tilde.club port 995 with ssl
+- smtp.tilde.club port 587 with starttls
+
+if you'd like your @tilde.club mail forwarded elsewhere, you can put an email 
+address in a file called `~/.forward`
+
+## sieve filtering
+
+our dovecot configuration supports [sieve](http://sieve.info/) and 
+[managesieve](https://wiki1.dovecot.org/ManageSieve).
+
+this means that you should put your scripts in a `~/sieve/` directory,
+symlink the active script to `~/.dovecot.sieve`, and make sure to compile it
+with `sievec ~/.dovecot.sieve`.
+
+you can find some example sieve scripts [here](
+https://wiki.dovecot.org/Pigeonhole/Sieve/Examples).
+
+alternately, you can use webmail's [filter settings](
+https://webmail.tilde.club/#/settings/filters) to configure your filters.
+

wiki/source/wiki.md

@@ -0,0 +1,24 @@
+---
+title: how to contribute to this wiki
+author: benharri
+---
+
+1. grab a copy of the site's source code
+
+    git clone https://github.com/tildeclub/site tilde.club && cd tilde.club/wiki
+
+1. make a new article or update an existing one (only change the markdown
+   source)
+
+1. generate the wiki pages. you need to be in the wiki directory.
+   run `./build-wiki.sh` to create the html.
+
+1. submit the code via a PR on github or with git-send-email(1) to root@tilde.chat
+   see [git-send-email.io](https://git-send-email.io) for more info on how to use
+   it. if you're working locally on tilde.club, you won't have to configure
+   anything; git will use the system's sendmail to handle the email.
+
+1. profit???
+
+ask on irc if you have questions!
+