Index: openacs-4/packages/assessment/www/doc/as_items.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/assessment/www/doc/as_items.html,v
diff -u -r1.3 -r1.4
--- openacs-4/packages/assessment/www/doc/as_items.html	21 Jul 2004 16:02:49 -0000	1.3
+++ openacs-4/packages/assessment/www/doc/as_items.html	28 Jul 2004 10:35:57 -0000	1.4
@@ -13,7 +13,7 @@
 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 (ie Sections) that can be used in an assessment. You are
+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
@@ -119,9 +119,9 @@
 perform as_item </li>
       <li> adp_chunk - a denormalization to cache the generated
 "widget"
-for the as_item (NB: when any change is made to an as_as_item_choice
+for the as_item (NB: when any change is made to an as_item_choice
 related
-to an as_as_item, this will have to be updated!) </li>
+to an as_item, this will have to be updated!) </li>
     </ul>
     <p> <i>Permissions / Scope</i>: as_items need a clearly defined
 scope, in
@@ -212,7 +212,7 @@
 response</li>
     <li>data_type - Integer vs. real number vs. text</li>
     <li>case_sensitive_p - Shall the match be case sensitive</li>
-    <li>score - Percentage a correct match gives<br>
+    <li>percent_score - Percentage a correct match gives<br>
     </li>
     <li>compare_by - How is the comparison done (equal, contains,
 regexp)</li>
@@ -300,7 +300,8 @@
       <li>sort_order - In which order shall this choice appear with
 regards to the MC item. Note, this can be overriden by the display type.<br>
       </li>
-      <li>score - Score given to the user if this choice is selected
+      <li>percent_score - Score given to the user if this choice is
+selected
 (in percent). <br>
       </li>
     </ul>
@@ -356,9 +357,9 @@
 specified by the author</li>
     <li>selected_p - Is this choice selected by default (when the
 item is presented to the user)</li>
-    <li>correct_answe_p<br>
+    <li>correct_answer_p<br>
     </li>
-    <li>score</li>
+    <li>percent_score</li>
     <li><span class="context"><span class="reg">area_type - Type of the
 area that uses the coordinates_string</span></span></li>
     <li><span class="context"><span class="reg">coordinates_string -
@@ -377,7 +378,7 @@
 the widget. Each widget has at least one item_display_type associated
 with it. In the long run I think this system has the potential to
 become a part of OpenACS itself (storing additional display information
-for each acs_object), but we are not there yet :). Obviouslly we are
+for each acs_object), but we are not there yet :). Obviously we are
 talking cr_item_types here as well.
 <p>Each item_display_type has a couple of attributes in common.
 </p>
@@ -424,8 +425,6 @@
   <li>short_answer (as_item_display_sa) - Multiple textboxes in one
 item.</li>
   <ul>
-    <li><span class="reg"></span><br>
-    </li>
     <li><span class="context"><span class="reg">abs_size - An
 abstraction of the real size value in
 "small","medium","large". Up to the developer how this translates.</span></span></li>
@@ -448,8 +447,6 @@
     <ul>
       <li> abs_size - An abstraction of the real size value in
 "small","medium","large". Up to the developer how this translates.</li>
-      <li><span class="context"><span class="reg"></span></span><br>
-      </li>
       <li>acs_widget - the
 type of "widget" displayed when the
 Item is output in html. There are many types we should support beyond
@@ -492,8 +489,7 @@
       <li>choice_label_orientation - how shall the label be positioned
 in relation to the choice (top, left, right, buttom).<br>
       </li>
-      <li>button_type - type of button to use</li>
-      <li>sort_order: Numerical, alphabetic, randomized or
+      <li>sort_order_type: Numerical, alphabetic, randomized or
 by order of entry (sort_order field).</li>
       <li><span class="context"><span class="reg"><span class="context"><span
  class="reg"> item_answer_alignment - the orientation between the
@@ -518,7 +514,7 @@
       <li>choice_label_orientation<br>
       </li>
       <li>allow_multiple_p - Is it allow to select multiple values ?</li>
-      <li>sort_order: Numerical, alphabetic, randomized or
+      <li>sort_order_type: Numerical, alphabetic, randomized or
 by order of entry (sort_order field).</li>
       <li><span class="context"><span class="reg"><span class="context"><span
  class="reg"> item_answer_alignment - the orientation between the
@@ -541,7 +537,7 @@
 "popup menu" (select box)<br>
   </li>
   <ul>
-    <li>sort_order: Numerical, alphabetic, randomized or
+    <li>sort_order_type: Numerical, alphabetic, randomized or
 by order of entry (sort_order field).</li>
     <li><span class="context"><span class="reg">allow_multiple_p - Is
 it allow to select multiple values ?</span></span></li>
@@ -567,8 +563,8 @@
       <span class="context"><span class="reg"><span class="context"><span
  class="reg"><span class="context"><span class="reg"></span></span></span></span></span></span></li>
     <li><span class="context"><span class="reg"><span class="context"><span
- class="reg"><span class="context"><span class="reg">
-item_answer_alignment - the orientation between the
+ class="reg"><span class="context"><span class="reg">item_answer_alignment
+- the orientation between the
 "question part" of the Item (the item_text/item_subtext) and the
 "answer part" -- the native Item widget (eg the textbox) or the 1..n
 choices. Alternatives accommodate L-&gt;R and R-&gt;L alphabets (or is
@@ -582,24 +578,24 @@
       <br>
       </span></span></span></span></span></span></li>
   </ul>
-  <li>multiple-choice-other: Consider, for instance, a combo box
+  <li>multiple-choice-other (as_item_display_mco): Consider, for
+instance, a combo box
 that consists of a radiobutton plus a textbox -- used for instance when
 you need a check "other" and then fill in what that "other" datum is.
 In effect this is a single Item but it has two different forms: a
 radiobutton and a textbox. The answer will NOT be stored in the answer
-choice table. There is no item_type "multiple-choice-other"
+choice table. There is no item_type "multiple-choice-other".
     <ul>
       <li>widget_choice - Type of the widget for the multiple choice
 part</li>
-      <li><span class="reg"><li>sort_order: Numerical, alphabetic,
+      <li>sort_order_type: Numerical, alphabetic,
 randomized or
 by order of entry (sort_order field).</li>
-        </span></li>
       <li> other_size: size of the other text field. </li>
       <li> other_label: label (instead of "other"). </li>
       <li><span class="context"><span class="reg"><span class="context"><span
- class="reg"><span class="context"><span class="reg">
-item_answer_alignment - the orientation between the
+ class="reg"><span class="context"><span class="reg">item_answer_alignment
+- the orientation between the
 "question part" of the Item (the item_text/item_subtext) and the
 "answer part" -- the native Item widget (eg the textbox) or the 1..n
 choices. Alternatives accommodate L-&gt;R and R-&gt;L alphabets (or is