Groups
We create two different groups for a course: one lists all instructors and the other all students. This allows us to assign read- and write-permissions for the respective subfolders of the courses.
All courses therefore have a group folder, which is not included in the "Groups" subfolder, but in the "Courses" directory:
Folders
Each course consists of several subfolders, which are either not bound, only readable, or writable depending on the status (instructor, student):
- feedback: Contains all feedback given by instructors when grading assignments.
- inbound: Serves as an exchange folder for student submissions when they are submitted for grading. Instructors can collect submissions using nbgrader.
- outbound: Also serves as an exchange folder for published tasks. Instructors can publish task descriptions using nbgrader.
- release: Stores the final versions of assignments. Typically, these are the same files as in the "outbound" folder.
- source: Instructors create and edit all tasks here.
Formgrader
ℹ️ We recommend using Formgrader, which will handle the creation and administration of tasks for you. The folders and files will be automatically created.
ℹ️ Students are automatically added to the gradebook.db database with their name and email address upon registration.
Unfortunately, the extension can only manage one course at a time. To do this, as a teacher, create the configuration file nbgrader_config.py at the root level. Add the following lines with the corresponding course name:
c = get_config()
c.CourseDirectory.course_id = "course_name"
c.CourseDirectory.root = "Courses/course_name"
Example Course
The folder structure of a course could look like this. In the table below, read-only (RO) and read-write (RW) permissions for three different people are shown.
| Pfad | Lehrkraft | Studi (baa0001) | Studi (bao1234) |
| feedback | RW | - | - |
| feedback / baa0001-uni-hamburg-de | RW | RW | - |
| feedback / bao1234-uni-hamburg-de | RW | - | RW |
| inbound | RW | - | - |
| inbound / baa0001-uni-hamburg-de | RW | RW | - |
| inbound / bao1234-uni-hamburg-de | RW | - | RW |
| outbound | RW | - | - |
| outbound / week-1 | RW | RO | RO |
| outbound / week-1 / task-1.ipynb | RW | RO | RO |
| release | RW | - | - |
| release / week-1 | RW | - | - |
| release / week-1 / task-1.ipynb | RW | - | - |
| source | RW | - | - |
| source / week-1 | RW | - | - |
| source / week-1 / task-1.ipynb | RW | - | - |
| source / week-2 | RW | - | - |
| source / week-2 / task-1.ipynb | RW | - | - |
| source / week-2 / task-2.ipynb | RW | - | - |