@@ -26,12 +26,26 @@ It can contain the following:
26
26
* `` "instructor_notes" `` : Shows notes for early warnings, plagiarism, etc. only to the instructor
27
27
* `` "grade_summary" `` : Shows the overall score and score for each syllabus bucket (e.g. Homework)
28
28
* `` "grade_details" `` : Shows the score for each gradeable
29
+ * `` "section" `` : Show the students' registration section.
30
+ * `` "messages" `` : Show a text message at the top of the page.
29
31
* `` "final_grade" `` : Shows final grade letters and some statistics about the final grade distribution.
32
+ * `` "manual_grade" `` : Manually assign final grades to specific students.
30
33
* `` "exam_seating" `` : Shows exam seating assignments. To display the assignment on the Submitty course homepage,
31
34
the instructor should make sure "Display Rainbow Grades Custom Message" is enabled in "Course Settings" on the Submitty
32
35
course page.
33
36
* `` "display_rank_to_individual" `` : Shows each student's rank in the course, independent of section.
34
37
38
+ ``` json
39
+ "display" : [
40
+ " grade_summary" ,
41
+ " grade_details" ,
42
+ " section" ,
43
+ " messages" ,
44
+ " final_grade" ,
45
+ " manual_grade"
46
+ ]
47
+ ```
48
+
35
49
* ** field:** `` "display_benchmark" ``
36
50
** type:** _ array of strings_
37
51
** REQUIRED** if using `` "curve" `` in `` "gradeables" `` described below
@@ -43,6 +57,18 @@ It can contain the following:
43
57
* `` "lowest_a- `` , `` "lowest_b-" `` , `` "lowest_c-" `` , `` "lowest_d" `` : Based on curves, the lowest scores that will earn
44
58
the name of the benchmark.
45
59
60
+ ``` json
61
+ "display_benchmark" : [
62
+ " average" ,
63
+ " stddev" ,
64
+ " perfect" ,
65
+ " lowest_a-" ,
66
+ " lowest_b-" ,
67
+ " lowest_c-" ,
68
+ " lowest_d"
69
+ ]
70
+ ```
71
+
46
72
* ** field:** `` "benchmark_percent" ``
47
73
** type:** _ associative array / mapping from string to float_
48
74
** REQUIRED** if using `` "curve" `` in `` "gradeables" `` described below, or if any grade-letter benchmarks are used in `` "display_benchmark" `` above.
@@ -51,6 +77,16 @@ It can contain the following:
51
77
necessary to obtain that grade. For example to require an 82% for an A-, there should be an entry in the `` "benchmark_percent" `` array:
52
78
`` "lowest_a-": 0.82 ``
53
79
80
+ To display all benchmarks, include the following:
81
+ ``` json
82
+ "benchmark_percent" : {
83
+ "lowest_a-" : 0.9 ,
84
+ "lowest_b-" : 0.8 ,
85
+ "lowest_c-" : 0.7 ,
86
+ "lowest_d" : 0.6
87
+ }
88
+ ```
89
+
54
90
* ** field:** `` "section" ``
55
91
** type:** _ associative array / mapping from string to string_
56
92
** REQUIRED**
@@ -60,34 +96,70 @@ It can contain the following:
60
96
this array will be treated as invalid and ignored. These labels are only displayed
61
97
on the instructor's ` output.html ` .
62
98
99
+ ``` json
100
+ "section" : {
101
+ "1" : " 1" ,
102
+ "2" : " 2" ,
103
+ "3" : " 3" ,
104
+ "4" : " 4" ,
105
+ "5" : " 5" ,
106
+ "6" : " 6" ,
107
+ "7" : " 7" ,
108
+ "8" : " 8" ,
109
+ "9" : " 9" ,
110
+ "10" : " 10"
111
+ }
112
+ ```
113
+
63
114
* ** field:** `` "messages" ``
64
115
** type:** _ array of strings_
65
116
66
117
These messages will be displayed at the top of the instructor summary and each
67
118
student's individual Rainbow Grades report.
68
119
120
+ ``` json
121
+ "messages" : [
122
+ " Example message"
123
+ ]
124
+ ```
125
+
69
126
* ** field:** `` "final_cutoff" ``
70
127
** type:** _ associative array / mapping from string to float_
71
128
** REQUIRED** if using `` "final_grade" `` in `` "display" ``
72
129
73
130
Each grade letter that you want should be associated with the minimum overall semester score required to get that grade.
74
- This array is unrelated to benchmarks.
131
+ This array is unrelated to benchmarks. For example:
132
+
133
+ ``` json
134
+ "final_cutoff" : {
135
+ "A" : 93.0 ,
136
+ "A-" : 90.0 ,
137
+ "B+" : 87.0 ,
138
+ "B" : 83.0 ,
139
+ "B-" : 80.0 ,
140
+ "C+" : 77.0 ,
141
+ "C" : 73.0 ,
142
+ "C-" : 70.0 ,
143
+ "D+" : 67.0 ,
144
+ "D" : 63.0
145
+ }
146
+ ```
75
147
76
148
* ** field:** `` "manual_grade" ``
77
- ** type:** _ associative array / mapping from string to associative array _
149
+ ** type:** _ array of associative arrays _
78
150
79
- For each student that you want to assign a manual grade to, their id must
80
- be mapped to an associative array with a field `` "grade" `` mapped to a string
81
- with the letter grade you want to give them, and `` "note" `` containing any note
82
- about the adjustment. The note is only visible to the instructor. For example,
151
+ For each student that you want to assign a manual grade to, add an item to
152
+ `` "manual_grade" `` with fields `` "user" `` , `` "grade" `` , and `` "note" `` containing
153
+ any note about the adjustment. The note is only visible to the instructor. For example,
83
154
to give user `` smithj `` a grade lettter of `` D `` with a reason of
84
155
`` "Put in extraordinary effort." `` :
85
156
86
157
``` json
87
- "smithj" : {
158
+ "manual_grade" : [{
159
+ "user" :" smithj" ,
88
160
"grade" : " D" ,
89
161
"note" : " Put in extraordinary effort."
90
- }
162
+ }]
91
163
```
92
164
93
165
* ** field:** `` "warning" ``
0 commit comments