Check out the content standards for guidance on writing quiz assessments.
Important points from the content standards:
- A quiz is a collection of assessments that is surfaced to the learner in a random order. It is intended to test a learners understanding of the learning standards covered in the preceding lesson.
- First answer of an assessment should be the correct answer (for maintainability).
- Don't use answers like "All of the above" or "None of the above" because answers are randomized.
- Negative words are highlighted with capitalization, like "Which of these is NOT true?"
Each assessment of a quiz should be associated to at least one learning standard (meaning you can test multiple learning standards within a single assessment). All learning standards of a module (if your module has more than one lesson, the quiz should test for learning standards from all lessons in the module) should be covered in the quiz.
Some example quiz drafts:
Check out the content standards for guidance on multiple choice assessments.
- A multiple choice assessment contains a question stem and 2 or more answer choices, of which only one can be correct. It optionally may also include an image or a code block to accompany the question stem.
- Ideally, a mutliple choice assessment should have 4 answer choices.
Question prompt
Learning Standard UUID(s):
- All learning standards have been uploaded to Author. There should be a table for the learning standards in each lesson outlines doc with UUIDs next to each learning standard. Please provide a list of UUIDs of learning standards that associates to the assessment.
- To view a learning standard in author, go to
http://author.codecademy.com/learning-standards/+ UUID.
Response: Correct response Reason: Affirmation. Optional reason why this response is correct.
- Reason text is displayed after a learner has selected an answer.
- If you provide a reason for a correct answer, start it with a one- or two-word affirmation like 'Well done!' or 'Correct!'
- If the learner could benefit from learning extra details or context as to why this answer is correct, you can optionally provide a reason why this response is correct.
Response: Incorrect response
- Wrong answers ("distractors") should be included for a reason. Every wrong answer should be a teachable moment.
- There are no arbitrary or "trick" wrong answers. Every wrong answer is a teachable moment.
- Trick: No wrong answer is specially formatted in such a way as to trick learners into picking it.
Reason: Not quite. Reason why this response is incorrect.
- Reason text is displayed after a learner has selected an answer.
- Reason for a wrong answer starts with a one- or two-word soft negation like "Not quite." or "Not exactly."
Response: Incorrect response Reason: Not quite. Reason why this response is incorrect.
Response: Incorrect response Reason: Not quite. Reason why this response is incorrect.
Check out the content standards for guidance on Fill In The Code (FITC) assessments.
- A Fill in the Code assessment contains a question stem and a partially completed code block, along with a variety of correct and incorrect code snippets that the learner must select to complete the code block correctly.
- Examples:
- React Hooks FITC Assessment in Author
- Learn C# FITC Assessment in Author
Fill in The Code question prompt
Code to be filled
- Write your code block and wrap sections of the code you would like learners to fill in with
__(double underscores).
Learning Standard UUID(s):
- All learning standards have been uploaded to Author. There should be a table for the learning standards in each lesson outlines doc with UUIDs next to each learning standard. Please provide a list of UUIDs of learning standards that associates to the assessment.
- To view a learning standard in author, go to
http://author.codecademy.com/learning-standards/+ UUID.
Response: Correct response Hint: A hint pointing learners in the right direction for this blank.
- The hint text will be displayed when the learner submits an incorrect option in this blank. It should provide a hint about what should go in this blank.
Response: Correct response Hint: A hint pointing learners in the right direction for this blank.
Response: Correct response Hint: A hint pointing learners in the right direction for this blank.
Extras: Extra option 1, Extra option 2...