Home

Welcome to the learn-ocaml-corpus wiki!

This wiki contains resources to write exercises and to help improve their quality.

Learn-OCaml documentation

How to evaluate an exercise submission?

1. Read the subject entirely and try to characterize the student that it is targeting, i.e.:

• What skills should she master?
• What skills is she currently learning?
• What is her background in computer science?
• What are her interests? What is motivating her?

2. Evaluate the pedagogical effect of the exercise.

• Can you understand it? Is the terminology sufficiently defined?
• Is the subject motivating enough?
• Does the structure of the exercise make sense? Are the dependencies between questions sufficiently clear?
• Is the purpose of the exercise clear enough in terms of what it will teach to the student?

3. Try to solve the exercise.

• Try out several wrong answers. For each of these wrong answers, take notes about it and about the quality of the grader and the reports it produces.
• Evaluate the difficulty of the exercise. Was it easy for you to find the answer? How long did it take? What kind of difficulties will be faced by the student?

4. Evaluate the reference answer.

• Is it correct?
• Is it possible for the student profiled in step 0 to find this answer by himself?
• Is it well-written? Is it clear enough?

Note that a good review not only evaluate the previous criteria but also suggests solutions for improvement.