You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/teacher/reference/response_area_components/index.md
+15-16Lines changed: 15 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,7 @@ You can duplicate the response area within the same part by clicking on the dupl
21
21
22
22
### Reorder
23
23
24
-
It is possible to reorder response areas within the part using the "drag and drop" feature. It works in the same way as reordering of parts.
24
+
It is possible to reorder response areas within the part using the "drag and drop" feature. It works in the same way as reordering parts.
25
25
26
26
### Delete Response Area
27
27
@@ -33,7 +33,8 @@ See more information about analytics for deleted response areas in [Analytics](.
33
33
34
34
## Response Area configuration
35
35
36
-
To configure a response area, click the configure button:
36
+
To configure a response area, click the configure button:
37
+
37
38

38
39
39
40
This opens the **Response Area Panel**, separated into four tabs:
@@ -59,9 +60,7 @@ This opens the **Response Area Panel**, separated into four tabs:
59
60
- Essay (for long text answers)
60
61
- Milkdown
61
62
62
-
Each field has suitable evaluation functions. For example, a simple numerical answer is best suited to 'Number', as this supports isSimilar, while assessing an equation is best suited to the 'Expression' field, as this supports compareExpressions.
63
-
64
-
In short, choose the most suitable input style for your desired answer.
63
+
Each input type has suitable evaluation functions. Try to choose the most suitable input style for your desired answer. See the subpages for more detailed information about each input type.
65
64
66
65
-**Configuration Options**
67
66
@@ -93,14 +92,14 @@ This is a 'no code' parametric configuration. Settings will be upgraded as the s
93
92
Here, you can go beyond a simple "correct/incorrect" and provide nuanced feedback by creating **"cases."**
94
93
95
94
Cases are an alternative answer you want to check for. You can use cases to:
96
-
* Award full marks for a different but equally valid answer.
97
-
* Identify a common mistake and provide specific, tailored feedback to help the student learn.
95
+
- Award full marks for a different but equally valid answer.
96
+
- Identify a common mistake and provide specific, tailored feedback to help the student learn.
98
97
99
98
For each case, you can:
100
-
* Enter an alternative answer to check for.
101
-
* Specify if the case should be marked as "correct" or "incorrect."
102
-
* Write custom feedback text that overrides the default feedback from the evaluation function.
103
-
* Change the color of the feedback (e.g., green for correct, orange for a hint).
99
+
- Enter an alternative answer to check for.
100
+
- Specify if the case should be marked as "correct" or "incorrect."
101
+
- Write custom feedback text that overrides the default feedback from the evaluation function.
102
+
- Change the color of the feedback (e.g., green for correct, orange for a hint).
104
103
105
104
Teachers typically add cases after students start submitting answers, and data about common student answers is created.
106
105
@@ -138,9 +137,9 @@ The reason why the input type change is restricted is to preserve high quality d
138
137
6.**Publish Again:** You publish `Version 2`.
139
138
140
139
**The Takeaway:**
141
-
* New student submissions will be recorded for "Response Area 1" (*Number*) and "Response Area 3" (*Table*).
142
-
* The original submissions to "Response Area 2" are safe and preserved with `Version 1`, but you won't see them in the analytics for the currently published `Version 2`.
143
-
* If you later **Revert** to `Version 1`, you will once again see the analytics for "Response Area 1" and the original "Response Area 2".
140
+
- New student submissions will be recorded for "Response Area 1" (*Number*) and "Response Area 3" (*Table*).
141
+
- The original submissions to "Response Area 2" are safe and preserved with `Version 1`, but you won't see them in the analytics for the currently published `Version 2`.
142
+
- If you later **Revert** to `Version 1`, you will once again see the analytics for "Response Area 1" and the original "Response Area 2".
144
143
145
144
**Please note:** All statistics and submissions are currently displayed against the published question version only. So, though the submissions against "Response Area 2" are preserved, it is not currently possible to see them. We are working on the improvement to make this possible.
146
145
@@ -155,6 +154,6 @@ This scenario works almost identically to the one above. The key is that once a
155
154
3.**Add a New Response Area:** You add "Response Area 3."
156
155
157
156
**The State of `Version 2` (Draft):**
158
-
* The input types for "Response Area 1" and "Response Area 2" are **locked**. This is because they exist on a previously saved version (`Version 1`). To change their type, you must go through the replacement process described above.
159
-
* The input type for the new "Response Area 3" is **unlocked**. You can change it freely because it doesn't exist on any previously saved version and has no associated student data to protect. It will only become locked after you Save or Publish `Version 2`.
157
+
- The input types for "Response Area 1" and "Response Area 2" are **locked**. This is because they exist on a previously saved version (`Version 1`). To change their type, you must go through the replacement process described above.
158
+
- The input type for the new "Response Area 3" is **unlocked**. You can change it freely because it doesn't exist on any previously saved version and has no associated student data to protect. It will only become locked after you Save or Publish `Version 2`.
0 commit comments