diff --git a/README.md b/README.md index b52a78e..0d7ee71 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,7 @@ # standaloneQuizApp -A simple standalone quiz applet to serve Moodle GIFT quizzes. +A simple standalone quiz applet to serve Moodle GIFT quizzes. A set of sample GIFT-formatted questions is provided (questions on French, English and Spanish syntax). These questions are generated by my [Corpus2Quiz processing chain](https://github.com/abalvet/ACE). + +This tool can be used to test your manually-edited GIFT questions, or use syntax-related automatically-generated questions from my [ACE repository](https://github.com/abalvet/ACE). + +The applet lets you load a set of GIFT-formatted questions (caveat: only basic GIFT compliance performed, only 1 correct answer expected) and render a quiz by shuffling questions and logging user responses. Upon quiz completion, a table is generated with interesting scores that Moodle does not provide: total time, time per question, average time per question, hesitations, total mouse distance and mouse distance per question. This applet is a very basic implementation: users can only click on "next" once they have selected 1 answer. They can't go back to correct a given response, or skip questions. This applet is meant as a standalone app for now, although LTI compliance is the next logical steps, in order to interface with LTI-capable LMS, such as Moodle. These features will be implemented in a future version of the applet. +In the meantime, the applet offers a quick and dirty way to test GIFT-formatted quizzes and collect relevant user stats. Detailed scores can be download as a TSV table.