Andal.LND/edx-platform
6
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

Working HTML docs

Browse Source
This commit is contained in:
Toddi Norum
2013-06-27 12:44:11 -04:00
committed by David Baumgold
parent 716e0e2713
commit 19c873e4a5
59 changed files with 2293 additions and 3725 deletions
Download Patch File Download Diff File Expand all files Collapse all files

109
userdocs/source/create_problem.rst
View File

@@ -1,19 +1,19 @@
****************
Create a Problem
****************
Overview
********
****************
Create a Problem
****************
Overview
********
The problem component allows you to add interactive, automatically graded exercises to your course content. You can create many different types of problems
in Studio.
By default, all problems are ungraded practice problems. To change the problems to graded problems, change the assignment type of the subsection.
By default, all problems are ungraded practice problems. To change the problems to graded problems, change the assignment type of the subsection.
To create a problem, determine:
• The type of problem that you want.
• The weight to assign to the problem.
@@ -28,21 +28,20 @@ Overview
• `Writing Exercises <https://edge.edx.org/courses/edX/edX101/How_to_Create_an_edX_Course/courseware/a45de3baa8a9468cbfb1a301fdcd7e86/d15cfeaff0af4dd7be4765cd0988d172/1>`_ has more in-depth discussion about problem types, and some general pedagogical considerations for adapting to the online format and a `Gallery of Response Types <https://edge.edx.org/accounts/login?next=/courses/edX/edX101/How_to_Create_an_edX_Course/courseware/a45de3baa8a9468cbfb1a301fdcd7e86/3ba055e760d04f389150a75edfecb844/1>`_
• The Appendix contains `XML Documentation <https://edge.edx.org/courses/edX/edX101/How_to_Create_an_edX_Course/jump_to/i4x:/edX/edX101/sequential/2b789a363cba4af09cbf5e14fd7a1a7f>`_ for the different problem response types.
• The :doc:`appendices/a` contains XML documentaion for the different problem response types.
• The `Discussion Forum <https://edge.edx.org/courses/edX/edX101/How_to_Create_an_edX_Course/discussion/forum">`_ for this class is a good place to ask questions about exercise types, report any errors or oddities that you may encounter, and get technical support.
• Creating problems for the online format opens a new playing field in the educational process. A big part of the community aspect of edX is to initiate and grow a `Creative Problems <https://edge.edx.org/courses/edX/edX101/How_to_Create_an_edX_Course/wiki/edx101/creative-problems/>`_ . Please look here to be inspired by new approaches when first making your class. Please also come back to post interesting approaches that you came up with while running your class, and to share with the community what worked well and what did not.
**Simple Editor and Advanced Editor**
**Simple Editor and Advanced Editor**
Studio offers two interfaces for editing problem components.
• The **Simple Editor** allows you to edit problems visually, without having to work with XML.
• The **Advanced Editor** converts the problem to edX's XML standard and allows you to edit that XML directly. For more information about
the XML for different problem types, see Appendix E: Problem Types
• The **Advanced Editor** converts the problem to edX's XML standard and allows you to edit that XML directly. For more information about the XML for different problem types, see Appendix E: Problem Types
Some of the simpler problem templates, including multiple choice, open in the Simple Editor and allow you to switch to the Advanced Editor. The more complicated problem types, such as Circuit Response, open in the Advanced Editor.
@@ -51,17 +50,17 @@ Overview
To open the Advanced Editor, click **Advanced Editor** in the top right corner of the Simple Editor.
.. image:: images/image275.png
:width: 400
.. image:: images/image275.png
:width: 400
The following is a multiple choice problem in the Advanced Editor.
.. image:: images/image276.png
:width: 400
Problem Type
.. image:: images/image276.png
:width: 400
Problem Type
************
Links to description of all the different problem types-brief. Then include links to all the XML, etc.
@@ -70,13 +69,13 @@ Problem Type
student to explain his or her response. You may also want a student to be able to check the answers to many problems at one time. To accomplish these
tasks, you can include multiple problems inside a single Problem component. (LINK)
Randomizing
Randomizing
***********
The **rerandomize** setting determines whether any random variable inputs for a problem are randomized each time a student loads the problem.
(This is only applicable to problems with randomly generated numeric variables.)
Scoring and Weight
Scoring and Weight
******************
Problems store a **point score** for submitted responses. The score that a student earns is the number of correct responses the student
@@ -107,7 +106,7 @@ Scoring and Weight
**Examples**
The following are some examples of setting problem weight and computing problem scores.
The following are some examples of setting problem weight and computing problem scores.
**Example 1**
@@ -115,14 +114,14 @@ Scoring and Weight
A problem with two response type inputs and a blank weight attribute has a maximum score of 2.0 points.
A student response to this problem that consists of one correct input value and one incorrect input value would be marked as having a score of 1.0 points
out of 2.0 points possible.
out of 2.0 points possible.
**Example 2**
A problem with three response type inputs and a weight attribute of 12 has a maximum score of 12.0 points.
A student response to this problem that consists of one correct input value and two incorrect input values would be marked as having a score of 4.0 points out of 12.0 points possible.
A student response to this problem that consists of one correct input value and two incorrect input values would be marked as having a score of 4.0 points out of 12.0 points possible.
**Example 3**
@@ -130,7 +129,7 @@ Scoring and Weight
A problem with four response type inputs and a weight attribute of 2 has a maximum score of 2.0 points.
A student response to this problem that consists of two correct input values and two incorrect input values would be marked as having a score of 0.5 of a point out of 2.0 points total.
**PROBLEM: 20.0 POINTS**
• The weight attribute for this problem has been changed from the default.
@@ -139,13 +138,13 @@ Scoring and Weight
• What number is the weight attribute of this problem set to?
• How many response inputs does this problem have?
• How many response inputs does this problem have?
• What is the default maximum score for this problem?
• If a response to this problem got one value right and the rest wrong, what score would it be assigned?
Close
Close
*****
To stop accepting responses and recording points, problems can be *closed.* Closed problems do not display a **Check** button. Students
@@ -161,7 +160,7 @@ Close
• Manually increase the number of attempts left for a given problem for a particular student from the Instructor tab in the live view of your course, when accessed in the Instructor view on Edge. This is recommended only for unusual situations, such as if you have to fix live problems during an exam.
Feedback
Feedback
********
Studio includes several tools to provide feedback to students: the **Check** button, the **Show Answer** button, and the **Attempts** setting. When you use the **Show Answer** button, you can also provide a detailed explanation of the answer.
@@ -185,8 +184,8 @@ Studio includes several tools to provide feedback to students: the **Check** but
In the following problem, enter a response, and then click **Check**. The problem tells you if your response is correct or incorrect.
Additionally, although you don't see it, a point score is also automatically stored for the response you submit.
.. image:: images/image277.png
.. image:: images/image277.png
**Show Answer button**
When a student clicks **Show Answer**, the problem shows the correct answers next to the corresponding response inputs and reveals any
@@ -195,17 +194,17 @@ Studio includes several tools to provide feedback to students: the **Check** but
In the following problem, the **Show Answer ** button appears after the student has made at least one attempt to answer. Enter a response that you know is wrong, and then click **Check**.
.. image:: images/image278.png
.. image:: images/image278.png
:width: 400
Now, click **Show Answer** to view the correct answer and its explanation.
.. image:: images/image279.png
Create a Problem
****************
.. image:: images/image279.png
Create a Problem
****************
*Note: You can also include non-graded exercises throughout your course.*
@@ -215,7 +214,7 @@ Create a Problem
Studio offers several templates that you can use. Alternatively, you can create your own problem type in XML.
For detailed information about different problem types, see
**Insert CR to APPENDIX A: Problem Types**
@@ -227,14 +226,14 @@ Create a Problem
The **Select Problem Component Type** screen appears. By default, the **Common Problem Types** tab is selected.
.. image:: images/image098.png
.. image:: images/image098.png
To see a list of more complex problem types, click the **Advanced** tab.
To see a list of more complex problem types, click the **Advanced** tab.
.. image:: images/image100.png
:width: 400
.. image:: images/image100.png
:width: 400
2. Click the problem type that you want.
@@ -245,16 +244,16 @@ Create a Problem
For example, if you click **Multiple Choice**, the following problem component appears.
.. image:: images/image102.png
:width: 400
.. image:: images/image102.png
:width: 400
3. Click **Edit**. This opens the Simple Editor for the problem component. The following example shows this view for a multiple choice
problem.
.. image:: images/image104.png
:width: 400
.. image:: images/image104.png
:width: 400
4. Set the problem attributes.
@@ -267,8 +266,8 @@ Create a Problem
c. In the **attempts **box, specify the number of attempts that you want to allow the student.
d. In the **showanswer** box, enter one of the following settings.
d. In the **showanswer** box, enter one of the following settings.
**Reference**
• **never** = The Show Answer button is never visible.
@@ -277,12 +276,12 @@ Create a Problem
• **attempted** = The Show Answer button appears after the student has checked an answer once, regardless of correctness.
• **always** = The Show Answer button always appears.
• **always** = The Show Answer button always appears.
5. Modify the problem text, and then click **Save** to save and check your work. Make sure to publish the draft you are working on to view the problem live.
Modify a Released Problem
Modify a Released Problem
*************************
**WARNING: Be careful when you modify problems after they have been released!**
@@ -293,8 +292,8 @@ Modify a Released Problem
• The score the student earned for that last response.
• The maximum point score for that problem.
• The maximum point score for that problem.
This information is updated when a student submits a response to a problem. If the student refreshes the **Progress** page, solutions are not re-checked. If a student refreshes the page of a problem, the latest version of the problem statement is loaded, but their previous response is NOT reevaluated. Rather, the previous response is loaded on top of the current problem statement. That is **existing** student responses for a problem are not reevaluated if the problem statement or attributes are changed, until a student goes back and resubmits the problem. Furthermore, as of the time of writing, if the problem weight attribute is changed, stored scores are re-weighted (without rechecking the response) when the student reloads the **Progress page.**
For example, you may release a problem that has two inputs. After some students have submitted answers, if you change the solution to one of the inputs, the existing student scores are not updated.
@@ -309,7 +308,7 @@ Modify a Released Problem
If you have to modify a released problem in a way that affects grading, you have two options. Note that both options require you to ask your students to go back and resubmit a problem.
1. Increase the number of attempts on the problem in the same Problem component. Then ask all the students in your class to redo the problem.
2. Delete the entire Problem component in Studio and create a new Problem component with the content and settings that you want. Then ask all the students in your course to go back to this assignment and complete problem.