From 7515eae11138a4b815988c76f9e93bf3bfb91187 Mon Sep 17 00:00:00 2001
From: Incogdino <javiertmw@gmail.com>
Date: Wed, 29 Jan 2025 17:47:00 +0800
Subject: [PATCH] Add question to docs

MCQ questions allow for more than one correct answer. Leaving it as
a tip is ambiguous and can cause confusion to users.

A separate question is added to show users how it can be done.
---
 docs/userGuide/syntax/questions.md | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/docs/userGuide/syntax/questions.md b/docs/userGuide/syntax/questions.md
index 7cf020c71..fe6c95afe 100644
--- a/docs/userGuide/syntax/questions.md
+++ b/docs/userGuide/syntax/questions.md
@@ -153,7 +153,7 @@ Optionally, you can provide the reason for the particular option using the `<q-o
 {% set mcqQuestion %}
 <question type="mcq" header="Which of these **contradicts** the heuristics recommended when creating test cases with multiple inputs?">
   <!-- Insert the reason for the option using the reason attribute -->
-  <q-option reason="This is **correct**. We need to figure out if a positive test case works!">
+  <q-option reason="This option **does not contradict the heuristics recommended**. We need to figure out if a positive test case works!">
     Each valid test input should appear at least once in a test case that doesn’t have any invalid inputs.
   </q-option>
   <q-option>
@@ -185,6 +185,32 @@ Optionally, you can provide the reason for the particular option using the `<q-o
 
 <box type="tip" seamless>MCQ questions can have multiple correct options!</box>
 
+{% set mcqQuestionWithMultipleAnswers %}
+<question type="mcq" header="Which of these is an example of gathering requirements for a product?">
+  <!-- Insert the reason for the option using the reason attribute -->
+  <q-option reason="Studying existing products can unearth shortcomings of existing solutions that can be addressed by a new product" correct>
+    Product surveys
+  </q-option>
+  <q-option reason="Observing users in their natural work environment is a way to uncover product requirements" correct>
+    Observation
+  </q-option>
+  <q-option reason="Assuming user needs directly opposes the idea of identifying the needs the product is made to solve">
+    User assumptions
+  </q-option>
+  <q-option reason="Focus groups can help to understand a specific issue, process, product, advertisement, etc." correct>
+    Focus groups
+  </q-option>
+  <div slot="hint">
+  There is more than one correct answer!
+  </div>
+</question>
+{% endset %}
+
+<include src="codeAndOutput.md" boilerplate >
+<variable name="highlightStyle">html</variable>
+<variable name="code">{{ mcqQuestionWithMultipleAnswers }}</variable>
+</include>
+
 **Checkbox Questions**
 
 {% set checkboxQuestion %}