source: main/waeup.kofa/branches/uli-py3/docs/source/userdocs/students.rst @ 17238

Last change on this file since 17238 was 13076, checked in by Henrik Bettermann, 9 years ago

After careful consideration: plural is more appropriate than singular.

A student section has another meaning: https://en.wikipedia.org/wiki/Student_section

File size: 1.8 KB
Line 
1.. _student_section:
2
3Students Section
4****************
5
6'Student' is a multi-purpose term in Kofa which may lead to some
7misconceptions. First of all, 'Student' is a Python/Grok container
8class and student objects are the instances of this class. Sometimes
9we are sluggish when talking about 'creating students' and actually
10mean: 'creating student container objects and storing the objects
11(persistently) in the ``students`` container'. The latter is the
12parent container for all students in the portal.
13
14The :ref:`treelike storage of objects <object_database>` in the
15students section can be figured as follows::
16
17
18  Students Section (StudentsContainer)
19  |
20  +---> Student
21        |
22        +---> StudentStudyCourse
23        |     |
24        |     +-----> StudentStudyLevel
25        |             |
26        |             +-----> CourseTicket
27        |
28        +---> StudentPaymentsContainer
29        |     |
30        |     +-----> StudentOnlinePayment
31        |
32        +---> StudentAccommodation
33              |
34              +-----> BedTicket
35
36
37.. note::
38
39  Throughout Kofa we distinguish singular and plural expressions. A
40  students container contains students (or more precisely student
41  containers), a payments container contains payments, a courses
42  container contains courses, a certificates container contains
43  certificates.
44
45Furthermore, a student is also a user of the portal and the student
46object is a user account surrogate, see :ref:`Applicants and
47Students <applicants_and_students>`. In the following we always
48refer to the student container when talking about a student.
49
50Interfaces
51==========
52
53.. toctree::
54   :maxdepth: 3
55
56   students/interfaces
57
58Workflow & History
59==================
60
61.. toctree::
62   :maxdepth: 3
63
64   students/workflow
65
66Browser Pages
67=============
68
69.. toctree::
70   :maxdepth: 3
71
72   students/browser
Note: See TracBrowser for help on using the repository browser.