Skip to content

Commit 8a94cff

Browse files
authored
[Documentation:InstructorUI] Add dates to upload (#601)
This PR adds documentation to go along with Submitty/Submitty#10252, adding dates to the upload JSON functionality. It also fixes grade inquiries which had the incorrect name, and values as stated in Submitty/Submitty#10188 (comment)
1 parent b3704ea commit 8a94cff

File tree

1 file changed

+58
-8
lines changed

1 file changed

+58
-8
lines changed

_docs/instructor/assignment_preparation/upload_gradeable.md

+58-8
Original file line numberDiff line numberDiff line change
@@ -41,15 +41,50 @@ __Other Electronic Types__
4141
```json
4242
"team_gradeable": {
4343
"team_size_max": 3,
44-
"inherit_from": "gradeable_id",
44+
"inherit_from": "gradeable_id"
4545
}
4646
```
4747
#### Grade inquiries
4848
```json
49-
"grading_inquiry": {
50-
"grade_inquiry_per_component_allowed": false,
49+
"grading_inquiries": false,
50+
"grade_inquiries_per_component": false,
51+
```
52+
### Dates
53+
All dates should be formatted as "yyyy-m-dd hh:ii:ss".
54+
55+
Four digit year, one or two digit month, two digit day, two digit hour, minute, and second.
56+
57+
* ta_view_start_date -- The date and time that the TA can view the gradeable
58+
* submission_open_date -- The date and time that submissions open
59+
* submission_due_date -- The date and time that submissions are due
60+
* grade_start_date -- The date that TAs can start grading
61+
* grade_due_date -- The date that TAs grades are due
62+
* team_lock_date -- The date that students can no longer join/change teams
63+
* grade_released_date -- The date that grades are released to students (only applicable if has_release_date is true)
64+
* grade_inquiry_start_date -- The date that grade inquiries can start to be submitted if grade inquiries are allowed
65+
* grade_inquiry_due_date -- The final day for grade inquiries if they are allowed.
66+
* has_due_date -- (true/false) If the gradeable has a due date,
67+
* has_release_date -- (true/false) If the gradeable has a grade_released_date
68+
* late_days_allowed -- (true/false) If students are allowed to use late days on the assignment
69+
* late_days -- The amount of late days students can use on the assignment
70+
```json
71+
"dates": {
72+
"ta_view_start_date": "2024-1-10 23:59:59.00",
73+
"submission_open_date": "2024-1-10 23:59:59.00",
74+
"submission_due_date": "2024-2-10 23:59:59.00",
75+
"grade_start_date": "2024-2-10 23:59:59.00",
76+
"grade_due_date": "2024-3-10 23:59:59.00",
77+
"team_lock_date": "2024-1-10 23:59:59.00",
78+
"grade_released_date": "2024-3-10 23:59:59.00",
79+
"grade_inquiry_start_date": "2024-3-10 23:59:59.00",
80+
"grade_inquiry_due_date": "2024-3-10 23:59:59.00",
81+
"has_due_date": false,
82+
"has_release_date": false,
83+
"late_days_allowed": false,
84+
"late_days": 3
5185
}
5286
```
87+
5388
#### Other
5489
* ta_grading -- If the TA will grade any/all of the assignments (Default false)
5590
* discussion_thread_id -- The thread ID if using forums (Default none)
@@ -68,15 +103,29 @@ __Other Electronic Types__
68103
},
69104
"team_gradeable": {
70105
"team_size_max": 3,
71-
"inherit_from": "gradeable_id",
106+
"inherit_from": "gradeable_id"
72107
},
73108
"bulk_upload": false,
74-
"grading_inquiry": {
75-
"grade_inquiry_per_component_allowed": false
76-
},
109+
"grading_inquiries": false,
110+
"grade_inquiry_per_component_allowed": false,
77111
"ta_grading": false,
78112
"discussion_thread_id": "thread_id",
79-
"syllabus_bucket": "Homework"
113+
"syllabus_bucket": "Homework",
114+
"dates": {
115+
"ta_view_start_date": "2024-1-10 23:59:59",
116+
"submission_open_date": "2024-1-10 23:59:59",
117+
"submission_due_date": "2024-2-10 23:59:59",
118+
"grade_start_date": "2024-2-10 23:59:59",
119+
"grade_due_date": "2024-3-10 23:59:59",
120+
"team_lock_date": "2024-1-10 23:59:59",
121+
"grade_released_date": "2024-3-10 23:59:59",
122+
"grade_inquiry_start_date": "2024-3-10 23:59:59",
123+
"grade_inquiry_due_date": "2024-3-10 23:59:59",
124+
"has_due_date": false,
125+
"has_release_date": false,
126+
"late_days_allowed": false,
127+
"late_days": 3
128+
}
80129
}
81130
```
82131
#### Sample Bulk Upload Template
@@ -111,3 +160,4 @@ __Other Electronic Types__
111160
"vcs_subdirectory": "subdirectory"
112161
},
113162
}
163+
```

0 commit comments

Comments
 (0)