Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Give a bit more structure to the description field, or just add more metadata fields? #440

christianp opened this issue Nov 7, 2018 · 0 comments


None yet
1 participant
Copy link

commented Nov 7, 2018

An important thing that I would like to see in the description of every question is "what is this question assessing?".

Often, descriptions only describe the setup, and what the student has to enter. The skills that are being assessed will be implied by those things, but aren't always clear. For example, a question where the student has to determine if a set of vectors is linearly independent might require them to apply Gaussian elimination, or might just ask them to recall a theorem.

So, I think the "description" field should give more prompts about what the author should write there. It would probably help to provide some structure by splitting the field into several boxes, each answering different questions:

  • What does the question assess?
  • What is the student asked to do?
  • How is the question randomised? (you might restrict yourself to an easily-generated subset of the possible values for the question, or contrive things to end up with a simple answer)
  • Notes about how the question was implemented (it's multiple choice because marking an arbitrary expression entered by the student would be too hard, for example)
  • Anything else (you might use this field to say which week's teaching the question corresponds to, or sections in a textbook)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.