Devilry can be translated to multiple languages and dialects. Each dialect makes Devilry feel more at home in its environment. A dialect translates special terms (see Special terms and concepts). This is important to understand when reading this documentation, because we use the special terms throughout the documentation, not the dialects.
Special terms and concepts¶
Devilry has some special terms and concepts. The most important (that cause most confusion) is:
- Period: A range of time. Typically a semester or a year.
- Examiner: Someone that provides feedback.
- Group: Students are always in a (project) group even when they work alone on an assignment.
More details about these and more terms and concepts follows below.
A Node is a place to organise top-level administrators (I.E.: administrators responsible for more than one Subject (course)). Nodes are organised in a tree. This is very flexible, and can be used to emulate most administrative hierarchies. A node is often a department, or some other organizational unit, but the exact use in your local Devilry instance depends on how you choose to organize administrators in Devilry.
Period (semester, year, ...)¶
A period is a limited span of time (I.E: january to july 2011) that you give a name (I.E.: Spring 2011). You register assignments on a period, and register students and examiners on each assignment.
Group, Candidate and Student¶
Students are not registered directly on an assignment. Instead a group is created, and one or more students is added as Candidates on that group. This means that project assignments, where students cooperate, is organized exactly like any other assignment. The only difference is the number of Candidates in each group.
A Candidate can also have a candidate ID, which is used to identify the student on anonymous assignments like exams.
Deadlines are individual for each group. They are organized below a Group in the Devilry hierarchy. In other words: Each Group has one or more deadlines.
Examiner is someone that writes feedback. Examiners are often one of these:
- A teacher that corrects their own students. They are usually Period or Subject administrator in addition to Examiner.
- A teaching assistant.
- Someone giving anonymous feedback on an exam.
A user becomes examiner when they are assigned as examiner for a group (See Group, Candidate and Student) by an administrator.
Special terms in context — a typical Devilry hierarchy¶
The tree below is an example of a typical Devilry hierarchy for a university named Duckburgh University with the special terms in brackets.
- Duckburgh University [Node]
- Department of Physics [Node]
- PHYS 101 — Introduction to physics [Subject (course)]
- Spring 2011 [Period (semester, year, ...)]
- Assignment one
Spring 2012 [Period (semester, year, ...)]
Spring 2013 [Period (semester, year, ...)]
PHYS 302 — Advanced physics [Subject (course)]