Rubric for Reviewing
To ensure that a
NormalExercise is suitably high quality for DataCamp, make sure it passes all these checks.
- Does the exercise pass all content guidelines, as shown in the build log?
- Is it written in sentence case?
- Is it informative?
- Does the text describe the problem that the exercise is designed to solve?
- Does the text introduce all new code that hasn't already been covered in another non-video exercise?
- Does the text not describe the steps to solve the exercise? (This belongs in the instructions.)
- Is setup mentioned? In particular, any pre-assigned varaibles should be mentioned.
- Does each instruction ask the student to describe a step to solve the exercise?
- Does each instruction make sense?
- Is each task something that has been demonstrated in a video exercise or previous coding exercise?
- Is each task specific?
- Is each task appropriately difficult?
- Does the instruction require the student to do more than copy and paste?
- Is there one code comment per instruction?
- Does each comment have sentence case?
- Does each comment make sense?
- Is an appropriate amount of code scaffolding in place?
- Is the code idiomatic for the target audience?
- Is there a hint for each instruction?
- Does each hint get the student about half way to the solution?
- Does the message include some praise?
- Does the message reinforce a learning objective, or preempt the next exercise?
- Do you think a student will learn something from taking the exercise?
- Is it clear what the main learning objective is?