apluslms / mooc-grader

Automatic assessment framework compatible with A-plus LMS.
14 stars 29 forks source link

Improve generic feedback on pick-any questions #151

Closed ihalaij1 closed 1 year ago

ihalaij1 commented 1 year ago

Description

What?

Add an additional feedback note on pick-anys when partial-points option is not used and the answer is incorrect.

image

Why?

Students sometimes assume that zero points means “nothing is correct”; moreover, they sometimes expect to get partial credit.

Fixes #150

Testing

What type of test did you run?

Tested that the new feedback note only shows in pick-any questions without partial-points option when the answer is incorrect.

Did you test the changes in

Translation

Programming style

Have you updated the README or other relevant documentation?

Is it Done?

ihalaij1 commented 1 year ago

I noticed that the note admonition is not displayed as a blue box on the individual exercise page (the CSS class is missing there?). Is this minor problem something that needs to be fixed?

markkuriekkinen commented 1 year ago

I noticed that the note admonition is not displayed as a blue box on the individual exercise page (the CSS class is missing there?). Is this minor problem something that needs to be fixed?

That is because the styles for the HTML class admonition note are only defined in the default.css file in A-plus-rst-tools: https://github.com/apluslms/a-plus-rst-tools/blob/9894bb18ca9a940455a132275b5ce7366847582a/theme/aplus/static/default.css#L53-L59

The A-plus-rst-tools styles only affect chapter pages since they are rendered to HTML by the rst tools (Sphinx).

This problem can be fixed by using the existing questionnaire feedback styles instead of adding a new info admonition. I would prefer to use the existing styles anyway.

ihalaij1 commented 1 year ago

I made changes according to the requests you made. If multiple hints are displayed, the new hint always appears last. Here's how it looks now: image

markkuriekkinen commented 1 year ago

I changed the git commit message and force-pushed.

markkuriekkinen commented 1 year ago

I now noticed that the original issue requested a slightly different trigger for the new hint:

IMO, it would be a good idea to insert an additional feedback bullet on pick-anys, to be displayed whenever a student’s answer is partially correct (i.e., something was right, but not everything).

In this pull request, the hint is triggered if the submission is partially correct or completely incorrect. However, I don't think this is an important distinction. After all, it is easy to make partially correct submissions since only one checkbox needs to be in the correct state in order to make it "partially" correct. Each checkbox is either ticked or not ticked. If the student leaves one easy obviously incorrect choice unticked, that already makes it a partially correct submission.

jsorva commented 1 year ago

Looks good to me, thanks @ihalaij1 and @Mankro!