qcm

git clone git://bebou.netlib.re/qcm
Log | Files | Refs | README |

commit 254d50a24a8b2b72f979a0049a5a5f5928445dce
parent dd00da8f2c99ec33cbdab1d81e3b08827893fd4d
Auteurice: Arthur Pons <arthur.pons@unistra.fr>
Date:   Thu,  7 Nov 2024 20:24:32 +0100

Documentation sur comment répondre

Ca me fait penser que maintenant que les questions sont à choix
multiples on peut plus n'autoriser qu'une seule réponse. Faut que
j'ajoute une option.

Diffstat:
M
README
 | 
50
++++++++++++++++++++++++++++++++++++++++++++------

1 file changed, 44 insertions(+), 6 deletions(-)
diff --git a/README b/README
@@ -27,13 +27,9 @@ nombre de question par défaut : 4 (ABCD)
 Il est possible de modifier le dossier de destination du script exécutable en
 modifiant la variable DEST dans le makefile.
 
-## Usage
+## Usages et exemples
 
-faire
-
-	qcm -h
-
-## Exemples
+### Créer des questionnaires
 
 Scanner le fichier de log `/var/log/nginx/access.log`, proposer quatre réponses
 `ABCD` et afficher l'url http://bebou.netlib.re/$id
@@ -81,6 +77,48 @@ Lancer un questionnaire en local sur un serveur équipé de `qcm` :
 
 	cat questionnaire.qcm | ssh -t user@server qcm -f -
 
+### Répondre aux questionnaires
+
+Il faut se munir de l'url du serveur, de l'identifiant du questionnaire, de
+l'intitutlé de la question et des choix de réponses. Ces infos sont connues de
+la personne ayant créé le questionnaire.
+
+Pour répondre à une question il faut créer et envoyer une requête HTTP GET au
+serveur à l'url :
+
+	url/identifiant/réponse
+
+Ainsi si l'url est `http://bebou.netlib.re`, l'identifiant `hjk` et la question
+:
+
+	om, psg ou les verts ?
+
+	A om
+	B psg
+	C les verts
+
+On pourra répondre "les verts" en envoyant la réquête à :
+
+	http://bebou.netlib.re/hjk/C
+
+Quand cela est prévu il est possible de choisir plusieurs réponses. Il faut
+alors bien les mettre dans l'ordre :
+
+	http://bebou.netlib.re/hjk/AC
+	et non pas
+	http://bebou.netlib.re/hjk/CA
+
+Pour les questions ouvertes il est possible de répondre n'importe quoi
+
+	http://bebou.netlib.re/hjk/cool cool je peux écrire ce que je veux
+
+Pour créer et envoyer cette requête le plus courant sera d'utiliser un
+navigateur web et d'entrer l'url dans la barre d'url/de recherche en haut. Il
+est également possible d'utiliser un programme comme `curl` ou `wget`.
+
+Puisque les pages qui correspondent n'existent pas une erreur 404 sera
+renvoyée. Pas d'inquiétude, la réponse a tout de même bien été prise en compte.
+
 ## Le format du fichier de questionnaire
 
 Le fichier de questionnaire est un fichier texte. Chaque question contient des