From ed7e895daaa2b6f6a47c7b2900200f7be8f0ae93 Mon Sep 17 00:00:00 2001 From: Stefan Sterz Date: Sun, 9 Sep 2018 23:13:09 +0200 Subject: [PATCH] doc: add proper readme --- README.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 660699f..e519d02 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,17 @@ -# wichteln +# Wichteln -A script that allows you to organise a secret santa game. \ No newline at end of file +This is a smalls script that allows you to organise a secret santa game (or +»Wichteln« in German). It has the follwing arguments: + +- `-h` displays a help message +- `-c FILE` or `--config FILE` specifies the location of the configuration file, which should contain all information needed to connect to an SMTP server. An example configuration file is given in `config.json`. It also defaults to `config.json`. +- `-p FILE` or `--participants FILE` specifies the location of the file containing a list of participants. An example configuration file is given in `participants.json`. It also defaults to `participants.json`. + +## participants.json Format +The `participants.json` file contains an array of objects. Each objects should specifiy the following three fields: + +- `name` The name of the participant +- `mail` The email adress of the participant +- `gender` This field is necessary, because this script has to send emails adressing each participant correctly and in german that depends on the gender of the recipient. However instead of just choosing a boolean value to represent gender, I chose to just store the actually needed information: the ending for the german word »Lieb(e|er|...)«. This allows for more then two genders and is in my opinion generally a little bit more elegant to use in this context. + +**Note:** This script was created in a german speaking context, if you want to adapt the emails that this script sends, change the text in lines 78 and 81-84.