diff --git a/docs/en_us/course_authors/source/change_log.rst b/docs/en_us/course_authors/source/change_log.rst index 781121d937..2e8df78972 100644 --- a/docs/en_us/course_authors/source/change_log.rst +++ b/docs/en_us/course_authors/source/change_log.rst @@ -18,6 +18,8 @@ October, 2014 Your Own Grader` chapter. * - - Fixed a bug in :ref:`Text Input Problem XML`. + * - + - Added :ref:`Create a Randomized Custom Python-Evaluated Input Problem` * - 10/23/14 - Added note about limited support of annotation problem type to :ref:`Annotation`. diff --git a/docs/en_us/course_authors/source/creating_content/create_problem.rst b/docs/en_us/course_authors/source/creating_content/create_problem.rst index b7da289256..84adeca75b 100644 --- a/docs/en_us/course_authors/source/creating_content/create_problem.rst +++ b/docs/en_us/course_authors/source/creating_content/create_problem.rst @@ -364,6 +364,8 @@ A problem’s weight is set to 2. The problem has four response fields. If a student’s response contains one correct answer and three incorrect answers, the student’s score is 0.5 out of 2 points. +.. _Randomization: + =============== Randomization =============== @@ -413,6 +415,8 @@ This setting has the following options. | | other students see. | +-------------------+--------------------------------------+ +.. note:: The edX Platform has a 20-seed limit for randomization. + =============== Show Answer =============== diff --git a/docs/en_us/course_authors/source/exercises_tools/custom_python.rst b/docs/en_us/course_authors/source/exercises_tools/custom_python.rst index e0ec65176b..8fc6ebdfb6 100644 --- a/docs/en_us/course_authors/source/exercises_tools/custom_python.rst +++ b/docs/en_us/course_authors/source/exercises_tools/custom_python.rst @@ -1,2 +1 @@ .. include:: ../../../shared/exercises_tools/custom_python.rst - diff --git a/docs/en_us/olx/source/change_log.rst b/docs/en_us/olx/source/change_log.rst index f704fef2cb..cecc70a35f 100644 --- a/docs/en_us/olx/source/change_log.rst +++ b/docs/en_us/olx/source/change_log.rst @@ -13,8 +13,11 @@ October, 2014 * - Date - Change + * - 10/28/14 - Added the section :ref:`Example of an OLX Course`. + * - + - Added :ref:`Create a Randomized Custom Python-Evaluated Input Problem` * - 10/23/14 - Fixed the code sample in :ref:`Script Tag Format` in the :ref:`Write Your Own Grader` chapter. diff --git a/docs/en_us/shared/exercises_tools/custom_python.rst b/docs/en_us/shared/exercises_tools/custom_python.rst index f5b0a3b4b9..6227cc8ced 100644 --- a/docs/en_us/shared/exercises_tools/custom_python.rst +++ b/docs/en_us/shared/exercises_tools/custom_python.rst @@ -288,3 +288,45 @@ The following template does not return answers when the student clicks **Show An +.. _Create a Randomized Custom Python-Evaluated Input Problem: + +***************************************************************** +Create a Randomized Custom Python-Evaluated Input Problem +***************************************************************** + +You can create a custom Python-evaluated input problem that randomizes +variables in the Python code. + +.. note:: + In the problem settings, you must set the **Randomization** value to + something other than **Never** to have Python variables randomized. See + :ref:`Randomization` for more information. + +The following example demonstrates using randomization with a Python-evaluated +input problem. + +.. note:: + This example uses the method ``random.randint`` to generate random numbers. You can use any standard Python library for this purpose. + +.. code-block:: xml + + +

Some problems in the course will utilize randomized parameters. + For such problems, after you check your answer you will have the option + of resetting the question, which reconstructs the problem with a new + set of parameters.

+ +

Let (x_1 = $x1) and (x_2 = $x2). What is the value of (x_1+x_2)?

+ + + + + +

Explanation:

+
+