Guide for Making Tests
Cards & their Associated Questions
To keep within budget, we have some limitations:
- a card can have only 1 version of a given question type, even in different tests
- tests can only contain 1 of a given card's question types at a time
What this means in practice is that if you have card X in one test and you choose its Fill in the Blanks question type, you'll not be able to use card X again in this test.
But! It's not all bad news.
Because you would have had to write out its Fill in the Blanks options, the next time you use that card in a different test you won't need to fill out its FITB options again.
The same would be true if you'd chosen the Multiple Choice Question type instead of FITB; you'd have to fill in the MCQ options for that card once, but the next time you use it you wouldn't have to fill it out again.
How to deal with the Question Types
Note: The following question types don't need additional content authored specifically for them, and so don't appear in a card's editable answer options:
Sentence Builder (Drag & Drop
Multiple Choice Questions
For ALL multiple choice question types, separate possible answers with | (the pipe character).
On UK ISO keyboards it's usually on the key next to the Enter key.
Do NOT include the correct answer. It will be included automatically.
MCQ (EN prompt -> answers in CY)
The question's prompt is the EN text taken from the card. The learner has choose the correct CY answer from the options provided.
Content example
ateb anghywir | anghywir hefyd | y trydydd opsiwn anghywir
MCQ (CY prompt -> answers in EN)
The question's prompt is the CY text taken from the card. The learner has choose the correct EN answer from the options provided.
Content example
incorrect answer | also incorrect | the third incorrect option
Audio MCQ (listen to CY audio, choose EN translation)
The question's prompt is the audio taken from the CY side of the card. The learner has choose the correct EN answer (in text form) from the options provided.
The options are taken from the MCQ (CY prompt -> answers in EN) above, so we don't need to double-up on authoring work.
It isn't perfect since we're limited to needing to reuse options, but budget constraints dictate this approach. We don't have an EN -> CY version because we only have EN audio for the first 2 Progression Steps.
Image MCQ (listen to CY audio, choose correct image)
The question's prompt is the audio taken from the CY side of the card. The learner has choose the correct image from the options provided.
list of image paths for cards.xlsx
Images aren't available for every deck in every Progression Step, so use your best judgement on what to include.
Content example
cardiau/110001.jpg | cardiau-gwreiddiol/130005.jpg | img/123456.jpg
(each of these would be an "incorrect" answer; the correct answer is taken from the card this question is associated with)
Fill in the Blanks
The question's prompt is taken from the EN side of the card and will be presented with something like "fill in the blanks for the Welsh translation of... X". The text you provide will be removed from the card's CY text, requiring the learner to type in what's now missing.
You can have multiple blanks - use | (the pipe character) to separate them.
Blanks can be anything - a single character, a word, or a phrase - but the text you enter is exactly what will be made into a blank (case is ignored, however, so you don't need to worry about capitals).
If you want to remove multiple instances of the same letter / word / phrase from a question, you'll have to add them multiple times.
e.g.
if the CY text was "Mae cathod yn wych; dw i'n hoffi cathod"
and your provided text was cathod | wych
the resultant question would be "Mae ______ yn ______; dw i'n hoffi cathod".
If you wanted "Mae ______ yn ______; dw i'n hoffi ______" as your question
your provided text would be cathod | wych | cathod.
Content example: one blank, word
Original EN Text: Good morning
Original CY Text: Bore da
Your text: bore
The resultant question:
Fill in the blanks for the translation of... Good morning
______ da
Content example: one blank, single character
Original EN Text: Good morning
Original CY Text: Bore da
Your text: r
The resultant question:
Fill in the blanks for the translation of... Good morning
Bo_e da
Content example: multiple blanks, word
Original EN Text: I like cats; they're cute
Original CY Text: Dw i'n hoffi cathod; maen nhw'n giwt
Your text: hoffi | cathod | giwt
The resultant question:
Fill in the blanks for the translation of... I like cats; they're cute
Dw i'n ______ ______; maen nhw'n ______
Content example: multiple blanks, single character
Original EN Text: I like cats; they're cute
Original CY Text: Dw i'n hoffi cathod; maen nhw'n giwt
Your text: ff | th | nh
The resultant question:
Fill in the blanks for the translation of... I like cats; they're cute
Dw i'n ho_i ca_od; maen _w'n giwt
Sentence Builder (Drag & Drop)
no additional content needs be authored for this type
When this question type is chosen, the card's CY text will be broken up into blocks (separated on each word), presented to the learner in a random order. They must then rearrange the blocks in the correct order.