← Back to branch summary

~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to doc/man/roles.rst

  • Committer: Matt Giuca
  • Date: 2010-07-22 00:46:45 UTC
  • mto: This revision was merged to the branch mainline in revision 1818.
  • Revision ID: matt.giuca@gmail.com-20100722004645-giso3xsjm8o8rflf
Project page: Removed the space before the '*'.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/man/roles.rst
 
1
.. IVLE - Informatics Virtual Learning Environment
 
2
   Copyright (C) 2007-2009 The University of Melbourne
 
3
 
 
4
.. This program is free software; you can redistribute it and/or modify
 
5
   it under the terms of the GNU General Public License as published by
 
6
   the Free Software Foundation; either version 2 of the License, or
 
7
   (at your option) any later version.
 
8
 
 
9
.. This program is distributed in the hope that it will be useful,
 
10
   but WITHOUT ANY WARRANTY; without even the implied warranty of
 
11
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
12
   GNU General Public License for more details.
 
13
 
 
14
.. You should have received a copy of the GNU General Public License
 
15
   along with this program; if not, write to the Free Software
 
16
   Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 
17
 
 
18
.. _ref-user-roles:
 
19
 
 
20
**********
 
21
User roles
 
22
**********
 
23
 
 
24
IVLE users can be given roles, giving them additional power in the system. The
 
25
roles are centered around a typical university teaching structure, with
 
26
tutors, lecturers and system administrators.
 
27
 
 
28
This page lists precisely what is permitted by each role.
 
29
 
 
30
Note that the roles are hierarchical. Being a member of a role implies all of
 
31
the powers of lesser roles.
 
32
 
 
33
Most roles are *per-offering*, which means the user only has the powers of
 
34
that role when dealing with a specific offering of a subject. (For example, a
 
35
lecturer of subject "ivle-101" for 2009 semester 1 is just an ordinary user
 
36
with respect to any other subject, or any other offering of "ivle-101").
 
37
 
 
38
Ordinary users
 
39
--------------
 
40
 
 
41
This is the default role for any user. Note that we do not refer to "ordinary
 
42
users" as "students", because "student" implies an enrolment in a particular
 
43
offering.
 
44
 
 
45
All users have the ability to:
 
46
 
 
47
* Store and edit files in the file system,
 
48
* Execute Python code in the Python console,
 
49
* Serve files privately and publicly,
 
50
* View and edit some of their own details (e.g., can edit display name, but
 
51
  not full name, which is required to be the user's formal name).
 
52
 
 
53
Students
 
54
--------
 
55
 
 
56
The role of "student" is offering-specific. Any user enrolled in an offering
 
57
is a "student" in that offering.
 
58
 
 
59
In addition to the abilities of ordinary users, students have the ability to:
 
60
 
 
61
* View the "subject page" for the offering,
 
62
* View any worksheet in the offering, and its exercises,
 
63
* Submit attempts at any exercise in any worksheet in the offering,
 
64
* Receive a mark for worksheet completion in the offering,
 
65
* Submit a solo project for the offering,
 
66
* Submit a group project for the offering, on behalf of any group they are in.
 
67
 
 
68
Tutors
 
69
------
 
70
 
 
71
The role of "tutor" is offering-specific. Users may be enrolled in an offering
 
72
as "tutor" by a lecturer or admin.
 
73
 
 
74
In addition to the abilities of students, tutors have the ability to:
 
75
 
 
76
* Create project groups, and add/remove students from them,
 
77
* View submissions to projects in the offering,
 
78
* Check out (with an external Subversion client) the part of a student or
 
79
  group's Subversion repository which was submitted to a project in the
 
80
  offering,
 
81
* Enrol a user in the offering as a student, if the system administrator has
 
82
  allowed it (see ``tutors_can_enrol_students`` under
 
83
  :ref:`policy configuration <ref-configuration-policy>`). This is
 
84
  **disabled** by default,
 
85
* Create and edit worksheets for the offering, if the system administrator has
 
86
  allowed it (see ``tutors_can_edit_worksheets`` under
 
87
  :ref:`policy configuration <ref-configuration-policy>`). This is **enabled**
 
88
  by default,
 
89
* View completion statistics for exercises in worksheets for the offering,
 
90
  if the system administrator has allowed it (see
 
91
  ``tutors_can_edit_worksheets`` under :ref:`policy configuration
 
92
  <ref-configuration-policy>`). This is **enabled** by default.
 
93
* Create and edit exercises *for any offering* (as exercises are not
 
94
  offering-specific), if the system administrator has allowed it (see
 
95
  ``tutors_can_edit_worksheets`` under :ref:`policy configuration
 
96
  <ref-configuration-policy>`). This is **enabled** by default.
 
97
 
 
98
Lecturers
 
99
---------
 
100
 
 
101
The role of "lecturer" is offering-specific. Users may be enrolled in an
 
102
offering as "lecturer" by an admin.
 
103
 
 
104
In addition to the abilities of tutors (including any of their policy-specific
 
105
abilities, regardless of the policy setting), lecturers have the ability to:
 
106
 
 
107
* Enrol a user in the offering, as a student or tutor,
 
108
* Create and edit worksheets for the offering,
 
109
* Create and edit exercises *for any offering* (as exercises are not
 
110
  offering-specific),
 
111
* Edit the details of the offering (such as description and URL),
 
112
* View individual students' worksheet marks for the offering,
 
113
* Create and edit projects and project sets for the offering.
 
114
 
 
115
Admins
 
116
------
 
117
 
 
118
The ultimate role is "admin". This is a site-wide role (it is not specific to
 
119
any offering).
 
120
 
 
121
Admins have the ability to:
 
122
 
 
123
* Do anything a lecturer can do in any offering,
 
124
* See stack traces when IVLE generates an internal server error (normal users
 
125
  see a generic error page),
 
126
* See a list of all users in the system,
 
127
* View and edit all details for all users, including "fixed" fields such as
 
128
  full name, and change any user's password without knowing the old one,
 
129
* Create new users,
 
130
* Enrol a user as a lecturer in any offering,
 
131
* Upgrade any user to admin status, or revoke admin status,
 
132
* Disable (ban) any user from accessing the system at all, or enable a user,
 
133
* See a list of all subjects and offerings in the system,
 
134
* Create new subjects and offerings,
 
135
* Edit the details of any subject (nb: not just an offering),
 
136
* Create new semesters,
 
137
* Change which subject/semester an offering is bound to.