@Incogdino The bug is in the UG example, or in the feature itself?

After reading this section through, it seems that the feature itself is not the issue, rather the way we provide the examples is slightly confusing.

The first option is indicated as a correct option but lacks correct as a parameter

The question for this example is asking for: which of the options contradicts the heuristics recommended?

The idea is that the first option is correct, meaning that it does not contradict the heuristics recommended, hence not the correct option to be chosen here. The question is intended to be single-answer, with the 4th option being the correct answer.

The tip (for multiple correct answers) that follows the question is standalone, and there is no example provided for this.

So the UG example is also actually correct. The issue is not in the correctness here, but in the wording. I think we just need to make the following documentation changes:

1. Re-word the reasoning for the first option from "correct" to "does not contradict the heuristics recommended".
2. Provide another example of a question with multiple correct options.

@Incogdino The bug is in the UG example, or in the feature itself?

I was referring to the UG example sorry for the confusion. The feature works as expected here.

@lhw-1

1. Re-word the reasoning for the first option from "correct" to "does not contradict the heuristics recommended".

I agree that this would be better if it was rephrased.

2. Provide another example of a question with multiple correct options.

Would it be better if this was left as a tip instead? Though allowed, according to proper heuristics, if there are multiple correct answers, users should choose to use a checkbox question instead of a multiple choice question.

Would it be better if this was left as a tip instead? Though allowed, according to proper heuristics, if there are multiple correct answers, users should choose to use a checkbox question instead of a multiple choice question.

I don't think this is true for all cases - I would consider an MCQ question with multiple correct answers vs. a Checkbox question with multiple correct answers to be two different use cases. (The first case might be useful if a question setter wants to be more "lenient" in a textbook quiz)

Leaving it as a tip is likely not going to cause huge problems per se, but given that (1) this issue was raised since the tip was initially thought to refer to the example above the tip, and (2) we can have more examples as needed (we are doing it for the Fill-in-the-Blanks Questions section), it might be worthwhile to at least clear up the potential confusion.

If providing an example seems to be overkill, we can expand / reword the tip so that there is no ambiguity, i.e. make it clear that the example shown is meant to be a single-answer question.

Would it be better if this was left as a tip instead? Though allowed, according to proper heuristics, if there are multiple correct answers, users should choose to use a checkbox question instead of a multiple choice question.

I don't think this is true for all cases - I would consider an MCQ question with multiple correct answers vs. a Checkbox question with multiple correct answers to be two different use cases. (The first case might be useful if a question setter wants to be more "lenient" in a textbook quiz)

Leaving it as a tip is likely not going to cause huge problems per se, but given that (1) this issue was raised since the tip was initially thought to refer to the example above the tip, and (2) we can have more examples as needed (we are doing it for the Fill-in-the-Blanks Questions section), it might be worthwhile to at least clear up the potential confusion.

If providing an example seems to be overkill, we can expand / reword the tip so that there is no ambiguity, i.e. make it clear that the example shown is meant to be a single-answer question.

Thanks for sharing your perspective. I see your point about MCQ and Checkbox questions serving different purposes, especially in cases where flexibility in grading is desired.

Given that the original concern stemmed from potential ambiguity in the tip, I agree that we should ensure clarity and should go along with adding an example to avoid ambiguity while still showing that it is possible to do so.