Changeset 13167 for main/waeup.kofa/trunk/docs

Timestamp:

13 Jul 2015, 08:37:27 (9 years ago)

Author:

Henrik Bettermann

Message:

More docs.

Location:

main/waeup.kofa/trunk/docs/source/userdocs

Files:

• academics.rst (modified) (1 diff)
• customization.rst (modified) (1 diff)
• documents.rst (modified) (2 diffs)
• hostels.rst (modified) (1 diff)

main/waeup.kofa/trunk/docs/source/userdocs/academics.rst

@@ -164 +164 @@
 above). A former course cannot be part of a curriculum.
 
-Certificate courses have to more attributes: `level` (integer) and
+Certificate courses have two more attributes: `level` (integer) and
 `mandatory` (boolean). Simply put, certificate courses carry the
 information at which level a certain course can or has to be taken

main/waeup.kofa/trunk/docs/source/userdocs/customization.rst

@@ -110 +110 @@
 used for sources (see :py:class:`API
 <waeup.kofa.utils.utils.KofaUtils>`) but also **configuration
-attributes** like
+attributes** like:
 
 .. autoattribute:: waeup.kofa.utils.utils.KofaUtils.PORTAL_LANGUAGE

main/waeup.kofa/trunk/docs/source/userdocs/documents.rst

@@ -1 +1 @@
 .. _documents:
 
-Public Documents
-****************
+Documents Section
+*****************
 
 The documents section of Kofa is a tiny built-in content management
@@ -10 +10 @@
 and registration procedures.
 
-Technically speaking, the documents section is a container of type
-`DocumentsContainer` with id ``documents``, which is located in the
-`IUniversity` instance and which contains documents. There are three
-types of public documents::
+Technically speaking, the documents section is a container of type `DocumentsContainer` with id ``documents``, which is located in the `IUniversity` instance and which contains public documents. There are three types of public documents::
 
-  Public Documents (DocumentsContainer)
+  Documents Section (DocumentsContainer)
   |
   +---> PDFDocument

main/waeup.kofa/trunk/docs/source/userdocs/hostels.rst

@@ -3 +3 @@
 Accommodation Section :sup:`in progress`
 ****************************************
+
+The accommodation sections is a built-in hostel management system. African universities usually run their own student hostels which are built on their huge university campuses. They combine the booking of beds with the registration process. There are two major use cases. Students either have to book a bed space before they can continue with the registration, or they are only allowed to book, if they have reached a certain registration state. In the first case, the university requires students to stay on campus. They usually have enough beds for all of their students and need to fill up the hostels. In the second case, bed space is limited. Since accommodation is usually very reasonable and much safer on campus than on the free market outside, students prefer accommodation on campus. If bed allocation e.g. requires the payment of school fees, students are forced to pay in order to get the highly coveted hostel bed. 
+
+Technically speaking, the accommodation section is a container of type `HostelsContainer` with id ``hostels``, which is located in the `IUniversity` instance. It contains hostels (instances of `IHostel`) which again contain the beds (instances of `IBed`).
+
+The :ref:`treelike storage of objects <object_database>` in the
+accommodation section can be figured as follows::
+
+
+  Accommodation Section (HostelsContainer)
+  |
+  +---> Hostel
+        |
+        +---> Bed
+
+Interfaces
+==========
+
+
+.. literalinclude:: ../../../src/waeup/kofa/hostels/interfaces.py
+   :pyobject: IHostelsContainer
+
+.. literalinclude:: ../../../src/waeup/kofa/hostels/interfaces.py
+   :pyobject: IHostel
+
+.. literalinclude:: ../../../src/waeup/kofa/hostels/interfaces.py
+   :pyobject: IBed