Merge pull request #533 from edx/carol/doc/revertPartialCredit

DOC: Changes to revert partial credit doc updates
openedx · Sep 11, 2015 · 2f3ed7d · 2f3ed7d
2 parents b933c2d + 630cf2b
commit 2f3ed7d
Show file tree

Hide file tree

Showing 10 changed files with 50 additions and 732 deletions.
diff --git a/en_us/olx/source/front_matter/change_log.rst b/en_us/olx/source/front_matter/change_log.rst
@@ -3,26 +3,7 @@ Change Log
 ############
 
 
-****************
-August 2015
-****************
 
-.. list-table::
-   :widths: 10 70
-   :header-rows: 1
-
-   * - Date
-     - Change
-   * - 25 August 2015
-     - Several additions were made to provide information about awarding
-       partial credit for problems.
-
-       * :ref:`Awarding Partial Credit for a Problem`
-       * :ref:`Awarding Partial Credit in a Checkbox Problem`
-       * :ref:`Awarding Partial Credit in a Dropdown Problem`
-       * :ref:`Awarding Partial Credit in a Multiple Choice Problem` 
-       * :ref:`Awarding Partial Credit in a Numerical Input Problem`
-       * :ref:`Award Half Credit` in a Write Your Own Grader Problem
 
 ****************
 July 2015

diff --git a/en_us/olx/source/problem-xml/create_problem.rst b/en_us/olx/source/problem-xml/create_problem.rst
@@ -418,7 +418,7 @@ element.
 
 .. include:: ../../../shared/exercises_tools/Section_adding_hints.rst
 
-.. include:: ../../../shared/exercises_tools/Section_partial_credit.rst
+.. Comment out partial credit.. include:: ../../../shared/exercises_tools/Section_partial_credit.rst
 
 .. _Modifying a Released Problem:
 

diff --git a/en_us/open_edx_course_authors/source/front_matter/change_log.rst b/en_us/open_edx_course_authors/source/front_matter/change_log.rst
@@ -32,17 +32,6 @@ August 2015
    * - Date
      - Change
    * - 26 August 2015
-     - Several additions were made to provide information about awarding
-       partial credit for problems.
-
-       * :ref:`Awarding Partial Credit for a Problem`
-       * :ref:`Awarding Partial Credit in a Checkbox Problem`
-       * :ref:`Awarding Partial Credit in a Dropdown Problem`
-       * :ref:`Awarding Partial Credit in a Multiple Choice Problem` 
-       * :ref:`Awarding Partial Credit in a Numerical Input Problem`
-       * :ref:`Award Half Credit` in a Write Your Own Grader Problem
-
-   * - 
      - Updated the :ref:`Course Data` topic to include descriptions of newly
        added values.
    * - 17 August 2015

diff --git a/en_us/shared/building_and_running_chapters/creating_content/create_problem.rst b/en_us/shared/building_and_running_chapters/creating_content/create_problem.rst
@@ -656,7 +656,7 @@ answers for all the problems in the component appear.
 
 .. include:: ../../../shared/exercises_tools/Section_adding_hints.rst
 
-.. include:: ../../../shared/exercises_tools/Section_partial_credit.rst
+.. Commenting out the partial credit; feature is reverted as of Sept 4 2015 until further notice include:: ../../../shared/exercises_tools/Section_partial_credit.rst
 
 .. _Problem Randomization:
 

diff --git a/en_us/shared/exercises_tools/Section_partial_credit.rst b/en_us/shared/exercises_tools/Section_partial_credit.rst
diff --git a/en_us/shared/exercises_tools/checkbox.rst b/en_us/shared/exercises_tools/checkbox.rst
@@ -14,17 +14,15 @@ Overview
 
 In checkbox problems, learners select one or more options from a list of
 possible answers. To answer the problem correctly, a learner must select all of
-the options that are correct answers, and none of the options that are
-incorrect. The course team must set up each checkbox problem to have at least
+the options that apply. Each checkbox problem must have at least
 one correct answer.
 
 .. image:: ../../../shared/building_and_running_chapters/Images/CheckboxExample.png
- :alt: A checkbox problem with four options, 2 of which are correct.
+ :alt: A checkbox problem with four options, 2 of which are required for the correct answer.
 
-.. note:: 
-   Make sure that all of the answer choices are unambiguous, and avoid trick
-   questions. Checkbox problems with ambiguity can be frustrating to learners,
-   especially if they have a limited number of attempts.
+.. note:: Make sure that all of the answer choices are unambiguous, and avoid
+   trick questions. Checkbox problems with ambiguity can be frustrating to
+   learners, especially if they have a limited number of attempts.
 
 **************************************************
 Analyzing Performance on Checkbox Problems
@@ -59,15 +57,15 @@ follow these steps.
    Component** select **Problem**.
 #. Select one of the two checkbox problem templates.
 
-   * From the list of **Common Problem Types**, select **Checkboxes**. 
+  * From the list of **Common Problem Types**, select **Checkboxes**. 
 
-   * From the list of **Common Problems with Hints and Feedback**, select
-     **Checkboxes with Hints and Feedback**. For more information, see `Use
-     Feedback in a Checkbox Problem`_.
+  * From the list of **Common Problems with Hints and Feedback**, select
+    **Checkboxes with Hints and Feedback**. For more information, see `Use
+    Feedback in a Checkbox Problem`_.
 
-   Studio adds the checkbox problem to the unit.
+    Studio adds the checkbox problem to the unit.
 
-#. Select **Edit**. The Simple Editor opens. 
+3. Select **Edit**. The Simple Editor opens. 
 #. Replace the sample problem text with your own text.
 #. Determine the text that describes the question you want learners to answer,
    and surround that text with two pairs of angle brackets (``>>question<<``).
@@ -373,177 +371,6 @@ or the advanced editor. For an overview of hints in problems, see
 
 .. include:: ../../../shared/exercises_tools/Subsection_configure_hints.rst
 
-.. _Awarding Partial Credit in a Checkbox Problem:
-
-*********************************************
-Awarding Partial Credit in a Checkbox Problem
-*********************************************
-
-You can configure a checkbox problem to award partial credit to learners
-who submit an answer that is partly correct. You must use the `Advanced Editor
-<Use the Advanced Editor to Edit a Checkbox Problem>`_ to configure partial
-credit.
-
-In the following example, the learner selected two of the three correct
-choices, and did not select any incorrect choices. The learner therefore had 4
-out of 5 correct answers. Because the course team set this problem up to award
-partial credit for every correct answer selected, and incorrect answer left
-unselected (known as `every decision counts`_), the learner earned 80%.
-
-.. image:: ../../../shared/building_and_running_chapters/Images/checkbox_partial_credit.png
- :alt: Image of a checkbox choice problem with partial credit for two out of
-     three answers.
- :width: 600
-
-For an overview of partial credit in problems, see
-:ref:`Awarding Partial Credit for a Problem`.
-
-There are two ways to award partial credit in a checkbox problem.
-
-.. contents::
-  :local:
-  :depth: 1
-
-.. _Every Decision Counts:
-
-======================================
-Using the Every Decision Counts Style
-======================================
-
-You can configure a checkbox problem so that the learner's response for every
-option is evaluated and scored. This is referred to as EDC, every decision
-counts.
-
-With EDC, for each option the learner gets wrong, either by not selecting a
-correct option or selecting an incorrect option, the learner's score is
-reduced by 1/n, where "n" is the number of options.
-
-For example, if there are four options, each one is worth 25% of the total
-score. If a learner's response is wrong for one option, she receives 75% of the
-points for the problem.
-
-To expand on this example, take a checkbox problem with four options, A, B, C,
-and D. Options A and B are correct, and C and D are incorrect. The following
-table describes the learner's score for different submissions for an EDC
-problem.
-
-.. list-table::
-     :widths: 20 20 20 20
-     :header-rows: 1
-
-     * - Learner's Selections
-       - Correct Answers
-       - Incorrect Answers
-       - Score
-     * - A, B, C
-       - A, B, D
-       - C
-       - 75%
-     * - A
-       - A, C, D
-       - B
-       - 75%
-     * - A, C
-       - A, D
-       - B, C
-       - 50%
-     * - C, D
-       - 
-       - A, B, C, D
-       - 0%
-
-Configure an EDC Checkbox Problem
-**********************************
-
-To configure an EDC checkbox problem, you add the
-attribute ``partial_credit="EDC"`` to the ``<choiceresponse>`` element in the
-problem XML. 
-
-For example, the following XML shows the checkbox problem template after it is
-updated to provide partial credit.
-
-.. code-block:: xml
-
-  <choiceresponse partial_credit="EDC">
-    <checkboxgroup label="Which of the following is a fruit? Check all that apply.">
-      <choice correct="true">apple</choice>
-      <choice correct="true">pumpkin</choice>
-      <choice correct="false">potato</choice>
-      <choice correct="true">tomato</choice>
-    </checkboxgroup>
-  </choiceresponse>
-
-=======================
-Using the Halves Style
-=======================
-
-You can configure a checkbox problem so that for every option a learner gets
-wrong, either by not selecting a correct option or selecting an incorrect
-option, half of the remaining points are subtracted from the problem. This is
-referred to as scoring by "Halves".
-
-For example, if a learner gets one out of four options wrong, he receives 50%
-of the points for the problem.
-
-To expand on the example above, in which options A and B are correct, and C and
-D are incorrect, the following table describes the learner's score for
-different submissions for a Halves problem.
-
-.. list-table::
-     :widths: 20 20 20 20
-     :header-rows: 1
-
-     * - Learner's Selections
-       - Correct Answers
-       - Incorrect Answers
-       - Score
-     * - A, B, C
-       - A, B, D
-       - C
-       - 50%
-     * - A
-       - A, C, D
-       - B
-       - 50%
-     * - A, C
-       - A, D
-       - B, C
-       - 0%
-     * - C, D
-       - 
-       - A, B, C, D
-       - 0%
-
-.. note:: 
-  For half of the remaining points to be deducted, the problem must have more
-  than twice the number of options than the number of incorrect answers in the
-  learner's response. Otherwise, the learner receives no credit for the
-  problem. For example, if the learner gets two out of four options wrong, he
-  receives no credit for the problem. If he gets two out of five options wrong,
-  he gets 25% of the points.
-
-
-Configure a Halves Checkbox Problem
-************************************
-
-To configure a Halves checkbox problem, you add the attribute
-``partial_credit="halves"`` to the ``<choiceresponse>`` element in the problem
-XML.
-
-For example, the following XML shows the checkbox problem template
-updated to provide partial credit.
-
-.. code-block:: xml
-
-  <choiceresponse partial_credit="halves">
-    <checkboxgroup label="Which of the following is a fruit? Check all that apply.">
-      <choice correct="true">apple</choice>
-      <choice correct="true">pumpkin</choice>
-      <choice correct="false">potato</choice>
-      <choice correct="true">tomato</choice>
-    </checkboxgroup>
-  </choiceresponse>
-
 
 .. _Checkbox Problem XML:
 
@@ -634,14 +461,8 @@ Specifies that the problem contains options for learners to choose from.
 
   Attributes
 
-  .. list-table::
-     :widths: 20 80
-
-     * - Attribute
-       - Description
-     * - partial_credit (optional)
-       - Specifies the type of partial credit given. ``EDC`` or ``halves``.
-
+  (none)
+
   Children
 
   ``<checkboxgroup>``