Skip to content

Commit e83b2f2

Browse files
committed
Clarified moderator role wording following review
1 parent 60ac971 commit e83b2f2

File tree

1 file changed

+17
-7
lines changed

1 file changed

+17
-7
lines changed

docs/advanced/administrators/user_access.md

Lines changed: 17 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -54,15 +54,17 @@ There are currently the following types of Teacher Roles:
5454

5555
### OWNER
5656

57-
This is a system-defined role. The administrator can only change its description. The administrator cannot delete this role or modify its permissions.
57+
This is a system-defined **role type**. Exactly one role exists with this type.
5858

59-
Role of this type grant access to modules for module owners. This role is assigned automatically to the user who creates a new module instance but can also be assigned or reassigned to other teachers on the module.
59+
The administrator can modify the role’s description, but cannot delete the role or change its permissions.
60+
61+
This role is assigned automatically to the user who creates a new module instance, but it may also be reassigned to other users with ADMIN or TEACHER base roles.
6062

6163
The role of this type provides **Teacher** access to the module.
6264

6365
### CUSTOM
6466

65-
This role type can be added, updated, or deleted by administrators.
67+
Roles of this **role type** can be added, updated, or deleted by administrators.
6668

6769
Administrators (or teachers with relevant permissions) can assign this role to users to grant them access to a module instance as teachers.
6870

@@ -76,19 +78,27 @@ There is currently the following type of Tutor Roles:
7678

7779
### PERSONAL TUTOR
7880

79-
This is a system-defined role. The administrator cannot delete this role but can modify its description and permissions, except for the **View student data** permission.
81+
This is a system-defined **role type**. The system provides a single role of this type.
82+
83+
The administrator cannot delete this role but can modify its description and permissions, except for the **View student data** permission.
8084

8185
This role is assigned indirectly using Global Tags, which group students into student groups and assign teachers or administrators as tutors to those groups.
8286

8387
A teacher or administrator gains access to a module if there is at least one student in that module who shares a Global Tag with the teacher or administrator. Access to the module is then restricted by the permissions assigned to the PERSONAL TUTOR role.
8488

85-
Although the tutor role includes the **View student data** permission, this permission is limited to only those students within the same tutor group (i.e., those sharing the same Global Tag), unless the same user would have a TEACHER ROLE to the same module with **View student data** permission. This differs from teacher access, where permissions apply to all students within the module.
89+
Although the tutor role includes the **View student data** permission, that permission applies **only** to students within the same tutor group (i.e. those sharing the same Global Tag), unless the same user would have a TEACHER ROLE to the same module with **View student data** permission. This differs from teacher access, where permissions apply to all students within the module.
90+
91+
**Tutor access** therefore represents indirect, student-scoped access to a module, rather than full module-level teacher access.
8692

87-
Role of this type provides **Tutor** access to the module.
93+
Role of this type provides **Tutor access** to the module.
8894

8995
## Moderator access
9096

91-
Moderator access is currently defined by the presence of the **Moderate student submissions** permission. In the current implementation, moderator access is modelled as a variant of teacher role assignment rather than as a separate access mechanism. As a result, a user may be assigned either teacher access or moderator access to a module, but not both simultaneously.
97+
Moderator access is currently defined by the presence of the **Moderate student submissions** permission. In the current implementation, moderator access is modelled as a variant of teacher role assignment rather than as a separate access mechanism.
98+
99+
As a result, a user may be assigned **either a “true” teacher role or a moderation-enabled teacher role** for a module, but cannot hold **both role assignments simultaneously**. A moderation-enabled role still grants teacher-level access to the module; however, it replaces any other teacher role assignment rather than layering on top of it.
100+
101+
This choice affects how roles are currently assigned in the UI. It does not imply that moderation represents an additional teaching responsibility, nor that multiple teacher-role assignments are conceptually required.
92102

93103
Any role (typically a CUSTOM role) with this permission enabled grants moderator access to a module.
94104

0 commit comments

Comments
 (0)