Here is a first suggestion for the help file:
Embedded answers (Cloze)
This very flexible question type is similar to a popular format known as the Cloze format.
Questions consist of a passage of text (in Moodle format) that has various answers embedded within it, including multiple choice, short answers and numerical answers.
If needed the multiple choice select element can be replaced by the standard radio buttons disposed either vertically or horizontally.
Note however that these buttons are displayed in a table and not imbedded in the text as the select element.
There is currently no graphical interface to create these questions - you need to specify the question format using the text box or by importing them from external files.
Here is an example of the input text used to specify such a question:
This question consists of some text with an answer embedded right here {1:MULTICHOICE:Wrong answer#Feedback for this wrong answer~Another wrong answer#Feedback for the other wrong answer~=Correct answer#Feedback for correct answer~%50%Answer that gives half the credit#Feedback for half credit answer} and right after that you will have to deal with this short answer {1:SHORTANSWER:Wrong answer#Feedback for this wrong answer~=Correct answer#Feedback for correct answer~%50%Answer that gives half the credit#Feedback for half credit answer} and finally we have a floating point number {2:NUMERICAL:=23.8:0.1#Feedback for correct answer 23.8~%50%23.8:2#Feedback for half credit answer in the nearby region of the correct answer}.
The multichoice question can also be shown in the vertical display of the standard moodle multiple choice.
{2:MCV:Wrong answer#Feedback for this wrong answer~Another wrong answer#Feedback for the other wrong answer~=Correct answer#Feedback for correct answer~%50%Answer that gives half the credit#Feedback for half credit answer}
Or in an horizontal display that is included here in a table
| The same multichoice in horizontal mode
|
{2:MCH:Wrong answer#Feedback for this wrong answer~Another wrong answer#Feedback for the other wrong answer~=Correct answer#Feedback for correct answer~%50%Answer that gives half the credit#Feedback for half credit answer}
|
.
Note that addresses like
www.moodle.org and smileys
all work as normal: a) How good is this? {:MULTICHOICE:=Yes#Correct~No#We have a different opinion} b) What grade would you give it? {3:NUMERICAL:=3:2} Good luck!
This example will appear to students as follows:
Question 1
Marks: --/12.00
This question consists of some text with an answer embedded right here Wrong answerAnother wrong answerCorrect answerAnswer that gives half the creditand right after that you will have to deal with this short answer and finally we have a floating point number .
The multichoice question can also be shown in the vertical display of the standard moodle multiple choice
|
1. Wrong answer
|
|
|
2. Another wrong answer
|
|
|
3. Correct answer
|
|
|
4. Answer that gives half the credit
|
|
.
|
Or in an horizontal display that is included here in a table
| The same multichoice in horizontal mode
|
|
1. Wrong answer
|
|
|
2. Another wrong answer
|
|
|
3. Correct answer
|
|
|
4. Answer that gives half the credit
|
|
|
.
Note that addresses like www.moodle.org and smileys 
all work as normal:
a) How good is this? YesNo
b) What grade would you give it?
Good luck!
The text of the question will be included in a textarea that cxannot be put on the editor forum.
Any comments wil be appreciate. Pierre
this could be "my" summer project.
) (Tim?)
