Index: openacs-4/packages/assessment/www/doc/as_items.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/assessment/www/doc/as_items.adp,v
diff -u -r1.9 -r1.10
--- openacs-4/packages/assessment/www/doc/as_items.adp 4 Aug 2018 09:34:07 -0000 1.9
+++ openacs-4/packages/assessment/www/doc/as_items.adp 3 Sep 2024 15:37:35 -0000 1.10
@@ -1,15 +1,19 @@
-{/doc/assessment {Assessment}} {As_Items}
+{/doc/assessment/ {Assessment}} {As_Items}
As_Items
+
Overview
TheĀ As_Item and Section catalogues
are central parts of the assessment system. These repositories
support reuse of Assessment components by storing of the various
as_items (or questions if you like) and groups of as_items (e.g.
Sections) that can be used in an assessment. You are able to
add/edit/delete an as_item of a certain type to a certain scope.
-Furthermore it allows you to search and browse for questions for
+Furthermore, it allows you to search and browse for questions for
inclusion in your assessment as well as import and export multiple
questions using various formats.
In this description here we will only
@@ -36,9 +40,9 @@
as_item_display instance.
Categorization and internationalization
-will make it into OpenACS 5.2, therefore we are not dealing with it
-in Assessment separately but use the (to be) built in functionality
-of OpenACS 5.2
+will make it into OpenACS 5.2, therefore, we are not dealing with
+it in Assessment separately but use the (to be) built in
+functionality of OpenACS 5.2
Additionally we have support functionality
for an as_item. This includes the help functionality. To give
Assessment authors flexibility in adapting as_item defaults, help
@@ -57,7 +61,7 @@
as_item-related subsystems, including the as_item Display subsystem
described here.
-
+
Core Function: as_items
-
@@ -97,7 +101,7 @@
system to grant access rights to an as_item.
- Read: An assessment author (who is
granted this permission) can reuse this as_item in one of his
-sections. (NB: Usually the original author has admin privileges.).
+sections. (NB: Usually, the original author has admin privileges.).
This is a finer granulation than the previous "enabled_p"
as it allows specific access to an item.
- Write: Author can reuse and change this
as_item.
- Admin: Author can reuse, change and give
@@ -192,7 +196,7 @@
as_item_type! This way we can reuse multiple choice answers
easier. It is debatable if we should allow n:m relationships
between choices and as_item_types (thereby allowing the same choice
-been reused). In my opinion this is not necessary, therefore we
+been reused). In my opinion this is not necessary, therefore, we
relate this using the parent_id (which will be treated as a
relationship in cr_child_rels by the content repository
internally). Following the Lars Skinny Table approach of conflating
@@ -362,7 +366,7 @@
- horizontal - all Choices are in one line
- vertical - all Choices are in one column
- choice_label_orientation - how shall the label be positioned in
-relation to the choice (top, left, right, buttom).
+relation to the choice (top, left, right, bottom).
- sort_order_type: Numerical, alphabetic, randomized or by order
of entry (sort_order field).
-
item_answer_alignment - the orientation
@@ -383,7 +387,8 @@
- checkbox (as_item_display_cb) - multiple-choice multiple-option
- choice_orientation (see above)
- choice_label_orientation
- - allow_multiple_p - Is it allow one to select multiple values ?
- sort_order_type: Numerical, alphabetic, randomized or by order
+
- allow_multiple_p - Is it allow one to select multiple values
+?
- sort_order_type: Numerical, alphabetic, randomized or by order
of entry (sort_order field).
-
item_answer_alignment - the orientation
between the "question part" of the Item (the