5/6/2013 Universal change to UTC for all GMT references. Changed “Add Course Catalog Information” to show URL and note that on this page, the course author sees local time from browser. Changed “Invite Students to Register” to reflect new link.
4/18/13 “Create a Discussion” graphic change
4/9/13 Changed order of sections (moved “Create a Lesson in Studio” after “Create a New Course”) Added content to “Export or Import a Course,”Create Lesson,” “Create Schedule,” and Upload a File to the Files & Updates Page” sections Revised “Add an Announcement or Update” section
7/1/2013 Online help and pdf files finalized in Sphinx 1.2b1
5/6/2013 Universal change to UTC for all GMT references. Changed “Add Course Catalog Information” to show URL and note that on this page, the course author sees local time from browser. Changed “Invite Students to Register” to reflect new link.
4/18/13 “Create a Discussion” graphic change
4/9/13 Changed order of sections (moved “Create a Lesson in Studio” after “Create a New Course”) Added content to “Export or Import a Course,”Create Lesson,” “Create Schedule,” and Upload a File to the "Files & Updates Page” sections. Revised “Add an Announcement" or Update" section.
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.
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:
To create a problem, determine:
• The type of problem that you want.
• The type of problem that you want.
• The weight to assign to the problem.
• The weight to assign to the problem.
• Whether you want to randomize the problem.
• Whether you want to randomize the problem.
• How to close the problem-that is, how to set the number of attempts a student has, [as well as set the due date].
• How to close the problem-that is, how to set the number of attempts a student has, [as well as set the due date].
• How you want to provide feedback to students; show answer on/off.
• How you want to provide feedback to students; show answer on/off.
This course contains several places with more information about creating exercises and integrating them into your course.
This course contains several places with more information about creating exercises and integrating them into your course.
• `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 :doc:`appendices/a` contains XML documentaion for the different problem response types.
• `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>`_
• `Appendix E <appendices/e.html>`_ 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.
• 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.
• 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**
Studio offers two interfaces for editing problem components.
Studio offers two interfaces for editing problem components.
• The **Simple Editor** allows you to edit problems visually, without having to work with XML.
• 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 <appendices/e.html>`_ .
• 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.
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.
*Note: You can switch at any time from the Simple Editor to the Advanced Editor by clicking "Advanced Editor" in the Simple Editor interface. However, there is no way to go back from the Advanced Editor to the Simple Editor without making a new component.*
.. note::
You can switch at any time from the Simple Editor to the Advanced Editor by clicking "Advanced Editor" in the Simple Editor interface. However, there is no way to go back from the Advanced Editor to the Simple Editor without making a new component.
To open the Advanced Editor, click **Advanced Editor** in the top right corner of the Simple Editor.
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: 600px
The following is a multiple choice problem in the Advanced Editor.
The following is a multiple choice problem in the Advanced Editor.
.. image:: images/image276.png
:width: 400
.. image:: images/image276.png
:width: 600px
.. raw:: latex
\newpage %
\newpage %
Problem Type
************
Links to description of all the different problem types-brief. Then include links to all the XML, etc.
Links to description of all the different problem types-brief. Then include links to all the XML, etc.
You may want to create a problem that has more than one response type. For example, you may want to create a multiple choice question, and then ask the
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)
You may want to create a problem that has more than one response type. For example, you may want to create a multiple choice question, and then ask the
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)
.. raw:: latex
\newpage %
\newpage %
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.)
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.)
.. raw:: latex
\newpage %
\newpage %
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
submits divided by the maximum score for the problem. The default maximum score, or weight, is the integer number of response type inputs the problem has.
Thus, the weight attribute for a problem with one response type input is set to 1 (one point). You can change the maximum score for an individual problem
by manually changing the problem **weight** attribute to another number. When you do this, the number of points that you specify appears next
to the problem title ( to one decimal precision).
Problems store a **point score** for submitted responses. The score that a student earns is the number of correct responses the student
submits divided by the maximum score for the problem. The default maximum score, or weight, is the integer number of response type inputs the problem has.
Thus, the weight attribute for a problem with one response type input is set to 1 (one point). You can change the maximum score for an individual problem
by manually changing the problem **weight** attribute to another number. When you do this, the number of points that you specify appears next
to the problem title ( to one decimal precision).
**WEIGHT: 0 POINTS**
**WEIGHT: 0 POINTS**
Scores are stored for all problems, but they only contribute to a student's grade in the course if they are part of a subsection marked as graded. For more
information, see the material on attempts and closing problems in 7B: Feedback and Grading.
Scores are stored for all problems, but they only contribute to a student's grade in the course if they are part of a subsection marked as graded. For more
information, see the material on attempts and closing problems in 7B: Feedback and Grading.
.. raw:: latex
\newpage %
\newpage %
**Computing Point Scores**
The point score of a response for a problem reflects the correctness of the response and is recorded as the number of points earned out of the maximum
possible score for the problem (also known as the problem weight). The formula used for computing the recorded point score is the following:
The point score of a response for a problem reflects the correctness of the response and is recorded as the number of points earned out of the maximum
possible score for the problem (also known as the problem weight). The formula used for computing the recorded point score is the following:
• **point score of response = problem weight * (# inputs correct / # total inputs)**
• **point score of response = problem weight * (# inputs correct / # total inputs)**
• **point score of response** is the point score "earned" by this response for the problem.
• **point score of response** is the point score "earned" by this response for the problem.
• **problem weight** is the maximum possible point score that can be earned for the problem. By default, this is the integer number of response types in that problem. This can be changed to another value by setting the weight attribute of the problem, as described in Setting Problem Attributes.
• **problem weight** is the maximum possible point score that can be earned for the problem. By default, this is the integer number of response types in that problem. This can be changed to another value by setting the weight attribute of the problem, as described in Setting Problem Attributes.
• ** # inputs correct** is the number of values for this response that were evaluated as correct by the response type fields.
• ** # inputs correct** is the number of values for this response that were evaluated as correct by the response type fields.
• **# total inputs** is the total number of response type fields in the problem.
• **# total inputs** is the total number of response type fields in the problem.
.. raw:: latex
\newpage %
\newpage %
**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**
**Example 1**
A problem with two response type inputs and a blank weight attribute has a maximum score of 2.0 points.
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.
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.
**Example 2**
**Example 2**
A problem with three response type inputs and a weight attribute of 12 has a maximum score of 12.0 points.
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**
**Example 3**
A problem with four response type inputs and a weight attribute of 2 has a maximum score of 2.0 points.
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.
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**
**PROBLEM: 20.0 POINTS**
• The weight attribute for this problem has been changed from the default.
• How many points is the entire problem worth?
• What number is the weight attribute of this problem set to?
• How many response inputs does this problem have?
• The weight attribute for this problem has been changed from the default.
• 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?
• How many points is the entire problem worth?
• What number is the weight attribute of this problem set to?
• 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?
.. raw:: latex
\newpage %
\newpage %
Close
*****
To stop accepting responses and recording points, problems can be **closed.** Closed problems do not display a **Check** button. Students
can still see questions, solutions, and revealed explanations in a closed problem, but they can no longer check their work, submit responses, or change their stored score.
To stop accepting responses and recording points, problems can be **closed.** Closed problems do not display a **Check** button. Students
can still see questions, solutions, and revealed explanations in a closed problem, but they can no longer check their work, submit responses, or change their stored score.
There are several ways that you can close problems:
There are several ways that you can close problems:
• Set a due date for the problems in a subsection. Note that you cannot set due dates for individual problems -- only for containing subsections (assignments). By default, due dates are not set. To set a due date, see LINK.
• Set a due date for the problems in a subsection. Note that you cannot set due dates for individual problems -- only for containing subsections (assignments). By default, due dates are not set. To set a due date, see LINK.
• Specify a grace period for your course. Note that the grace period applies to the entire course. To set a grace period, see LINK.
• Specify a grace period for your course. Note that the grace period applies to the entire course. To set a grace period, see LINK.
• Set the number of attempts for the individual problem component. The attempts setting determines the number of times a student is allowed to check their answer by clicking Check before the problem closes. If this field is left blank, a student has unlimited attempts. If you specify a number for the attempts setting, the number of total allowed and remaining attempts appears next to the Check button for the problem. Problems with a limited number of attempts also always display a Save button that allows response values to be saved without being submitted. When there is only one submission left, the student will receive a warning, and the Check button will be replaced with a Final Check button. When no attempts are left, both the Save and Check button will disappear.For more information, see Problem Attributes.
• Set the number of attempts for the individual problem component. The attempts setting determines the number of times a student is allowed to check their answer by clicking Check before the problem closes. If this field is left blank, a student has unlimited attempts. If you specify a number for the attempts setting, the number of total allowed and remaining attempts appears next to the Check button for the problem. Problems with a limited number of attempts also always display a Save button that allows response values to be saved without being submitted. When there is only one submission left, the student will receive a warning, and the Check button will be replaced with a Final Check button. When no attempts are left, both the Save and Check button will disappear.For more information, see Problem Attributes.
• 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.
• 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.
.. raw:: latex
\newpage %
\newpage %
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.
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.
TBD-SCREENSHOT OF PROBLEM WITH THESE ELEMENTS CIRCLED
TBD-SCREENSHOT OF PROBLEM WITH THESE ELEMENTS CIRCLED
**Check Button**
**Check Button**
The student clicks the **Check** button to submit a response. The problem module then performs the following steps.
The student clicks the **Check** button to submit a response. The problem module then performs the following steps.
• Accepts and stores the responses entered into each input.
• Accepts and stores the responses entered into each input.
• Checks the response values against the correct answers or solutions using an automatic grader.
• Checks the response values against the correct answers or solutions using an automatic grader.
• Visually marks the correct responses with a green check mark and the incorrect responses with a red x.
• Visually marks the correct responses with a green check mark and the incorrect responses with a red x.
• Stores the point score earned by this response for this problem for this student.
• Stores the point score earned by this response for this problem for this student.
If a student wants to save but not submit a response, the student can click **Save**.
If a student wants to save but not submit a response, the student can click **Save**.
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.
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
:width: 400
.. image:: images/image277.png
:width: 600px
**Show Answer button**
**Show Answer button**
When a student clicks **Show Answer**, the problem shows the correct answers next to the corresponding response inputs and reveals any
additional explanations that you have provided. **Show Answer** is controlled by the **showanswer** attribute in the problem
editor. It can be set to be never visible, always visible, or visible only when the problem has closed. [Reference: Setting Problem Attributes.]
When a student clicks **Show Answer**, the problem shows the correct answers next to the corresponding response inputs and reveals any
additional explanations that you have provided. **Show Answer** is controlled by the **showanswer** attribute in the problem
editor. It can be set to be never visible, always visible, or visible only when the problem has closed. [Reference: Setting Problem Attributes.]
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**.
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
:width: 400
.. image:: images/image278.png
:width: 600px
Now, click **Show Answer** to view the correct answer and its explanation.
Now, click **Show Answer** to view the correct answer and its explanation.
.. image:: images/image279.png
:width: 400
.. image:: images/image279.png
:width: 600px
.. raw:: latex
\newpage %
\newpage %
Create a Problem
****************
.. note::
*Note: You can also include non-graded exercises throughout your course.*
You can also include non-graded exercises throughout your course.
To add interactive, automatically graded exercises to your course content, use the Problem component. This component allows you to include an explanation
that the student can see when the student clicks **Show Answer**.
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**
To add interactive, automatically graded exercises to your course content, use the Problem component. This component allows you to include an explanation
that the student can see when the student clicks **Show Answer**.
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 `Appendix E <appendices/e.html>`_.
1. Under **Add New Component**, click **Problem**.
1. Under **Add New Component**, click **Problem**.
.. image:: images/image096.png
.. image:: images/image096.png
:width: 600px
The **Select Problem Component Type** screen appears. By default, the **Common Problem Types** tab is selected.
.. image:: images/image098.png
The **Select Problem Component Type** screen appears. By default, the **Common Problem Types** tab is selected.
.. image:: images/image097.png
:width: 600px
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/image099.png
:width: 600px
2. Click the problem type that you want.
*Note To create your own problem in XML, click "Empty" to open a blank XML editor.*
2. Click the problem type that you want.
A new problem component with sample template text appears.
.. note::
To create your own problem in XML, click "Empty" to open a blank XML editor.
A new problem component with sample template text appears.
For example, if you click **Multiple Choice**, the following problem component appears.
For example, if you click **Multiple Choice**, the following problem component appears.
.. image:: images/image102.png
:width: 400
.. image:: images/image101.png
:width: 600px
3. Click **Edit**. This opens the Simple Editor for the problem component. The following example shows this view for a multiple choice
problem.
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/image103.jpg
:width: 600px
4. Set the problem attributes.
4. Set the problem attributes.
In the **display_name** box, type the text that you want the student to see when the student hovers over the icon in the bar at the top of the page. This text also appears as a header for the problem.
In the **display_name** box, type the text that you want the student to see when the student hovers over the icon in the bar at the top of the page. This text also appears as a header for the problem.
a. In the **weight** box, set a weight for the problem. If you want the problem to be a practice problem, set this to zero (0).
b. In the **rerandomize** box,
c. In the **attempts** box, specify the number of attempts that you want to allow the student.
a. In the **weight** box, set a weight for the problem. If you want the problem to be a practice problem, set this to zero (0).
b. In the **rerandomize** box,
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.
.. raw:: latex
\newpage %
\newpage %
**Reference**
**Reference**
• **never** = The Show Answer button is never visible.
• **never** = The Show Answer button is never visible.
• **closed** = The Show Answer button is not visible if either the due date has passed, or the student has no attempts left.
• **closed** = The Show Answer button is not visible if either the due date has passed, or the student has no attempts left.
• **attempted** = The Show Answer button appears after the student has checked an answer once, regardless of correctness.
• **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.
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.
.. raw:: latex
\newpage %
\newpage %
Modify a Released Problem
*************************
**WARNING: Be careful when you modify problems after they have been released!**
Currently, problems cache the following information per student:
Currently, problems cache the following information per student:
• The student's last **submitted** response.
• The student's last **submitted** response.
• The score the student earned for that last response.
• 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.
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.
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.
Example: If you change the number of inputs to three, students who submitted answers before the change will have a score of 0, 1, or 2 out of 2.0. Students who submitted answers after the change will have scores of 0, 1, 2, or 3 out of 3.0 for the same problem.
Example: If you change the number of inputs to three, students who submitted answers before the change will have a score of 0, 1, or 2 out of 2.0. Students who submitted answers after the change will have scores of 0, 1, 2, or 3 out of 3.0 for the same problem.
However, if you go in and change the weight of the problem, the existing scores update when you refresh the **Progress** page.
However, if you go in and change the weight of the problem, the existing scores update when you refresh the **Progress** page.
Note that the behavior of re-grading in case of error is an edX Edge case. It is dependent on the implementation of grading, and may change. The goal in the future is to include re-grading that will allow some basic updates to live problems, whether or not students have submitted a response.
Note that the behavior of re-grading in case of error is an edX Edge case. It is dependent on the implementation of grading, and may change. The goal in the future is to include re-grading that will allow some basic updates to live problems, whether or not students have submitted a response.
.. raw:: latex
.. raw:: latex
\newpage %
\newpage %
Workarounds
===========
Workarounds
===========
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.
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.
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.
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.
Check your **Progress** view or the **Instructor** tab on Edge as described in the Viewing Scores unit to see if point scores are being stored as you expect. If there are issues with stored scores that you do not understand or cannot fix, contact support on the Studio help page.
Check your **Progress** view or the **Instructor** tab on Edge as described in the Viewing Scores unit to see if point scores are being stored as you expect. If there are issues with stored scores that you do not understand or cannot fix, contact support on the Studio help page.
For a discussion of some trade-offs and some suggestions for cleaner solutions in the future, see the following `discussion thread <http://help.edge.edx.org/discussions/questions/73-what-if-you-discover-that-a-live-problem-is-wrong">`_ on the Studio help desk.
For a discussion of some trade-offs and some suggestions for cleaner solutions in the future, see the following `discussion thread <http://help.edge.edx.org/discussions/questions/73-what-if-you-discover-that-a-live-problem-is-wrong">`_ on the Studio help desk.
You can include multiple problems of different types inside a single Problem component, even if you select a particular template when you create a problem. A template is simply an XML editor with template text already filled in. You can add to or replace the template text.
\ No newline at end of file
You can include multiple problems of different types inside a single Problem component, even if you select a particular template when you create a problem. A template is simply an XML editor with template text already filled in. You can add to or replace the template text.
@@ -9,47 +9,52 @@ To add a video to the unit, you must upload your video to YouTube, and then crea
You can include videos that run at 0.75 speed, 1.25 speed, and 1.50 speed as well as at normal speed. To do this, you must upload each of these videos to YouTube separately.
*Note YouTube only hosts videos of up to 15 minutes. If you encode a 0.75 speed option, you must make
sure that source video segments are only 11.25 minutes long so that YouTube can host all speeds.
YouTube offers paid accounts that relax this restriction.*
.. note::
1. Upload the video that you want to YouTube. Make note of the code that appears between **watch?v**
= and **&feature** in the URL. This code appears in the green box below.
YouTube only hosts videos of up to 15 minutes. If you encode a 0.75 speed option, you must make
sure that source video segments are only 11.25 minutes long so that YouTube can host all speeds.
YouTube offers paid accounts that relax this restriction.
.. image:: images/image053.png
:width: 800
2. In Studio, go to the unit that you want.
1. Upload the video that you want to YouTube. Make note of the code that appears between **watch?v**
= and **&feature** in the URL. This code appears in the green box below.
3. Under **Add New Component,** click **Video.**
.. image:: images/image053.png
:width: 800 px
4. In the screen that appears, click **default.**
2. In Studio, go to the unit that you want.
5. When the new video component appears, click **edit**.** A video component opens, and a sample video
begins playing automatically.
3. Under **Add New Component,** click **Video.**
6. In the **display_name** box, type the text that you want the student to see when the student hovers
the mouse over the icon in the bar at the top of the page. This text also appears as a header
for the video.
4. In the screen that appears, click **default.**
7. Change the codes in the green boxes to the YouTube codes that you noted in step 1. The first
code (immediately to the right of "0.75:") corresponds to the video at 0.75 speed, the next
corresponds to 1.0 speed, etc.
5. When the new video component appears, click **edit**.** A video component opens, and a sample video
begins playing automatically.
.. image:: images/image055.png
:width: 800
6. In the **display_name** box, type the text that you want the student to see when the student hovers
the mouse over the icon in the bar at the top of the page. This text also appears as a headerfor the video.
8. Click **Save.**
7. Change the codes in the green boxes to the YouTube codes that you noted in step 1. The first
code (immediately to the right of "0.75:") corresponds to the video at 0.75 speed, the next
corresponds to 1.0 speed, etc.
*Note All videos embedded using the edX player begin playing automatically. There is currently no way
to turn off the autoplay feature.*
.. image:: images/image055.png
:width: 800
8. Click **Save.**
.. note::
All videos embedded using the edX player begin playing automatically.
There is currently no way to turn off the autoplay feature.
**To add a transcript for your video:**
1. Save your srt.sjson file as **subs_YOUTUBEID.srt.sjson,** where **YOUTUBEID** is the YouTube ID of your video.
1. Save your srt.sjson file as **subs_YOUTUBEID.srt.sjson,** where **YOUTUBEID** is the YouTube ID of your video.
2. Upload the **subs_YOUTUBEID.srt.sjson** file to the **Files & Uploads** page.
2. Upload the **subs_YOUTUBEID.srt.sjson** file to the **Files & Uploads** page.
3. Create a link to this file by following the steps in the Add Items to the Handouts Sidebar
section.
3. Create a link to this file by following the steps in the Add Items to the Handouts Sidebar
2. In the **Course Schedule** section, enter the date you want your course to start in the **Course Start Date** box, and then enter the time you want your course to start in the **Course** **Start Time** box.
*Note: The Course Start Time on this screen will reflect the current time zone in your browser, depending on your geography. Course start times for students will show as UTC on Edge.*
.. note::
The Course Start Time on this screen will reflect the current time zone in your browser, depending on your geography. Course start times for students will show as UTC on Edge.
3. In the **Course Schedule** section, enter the date you want your course to end in the **Course** **End Date **
...
...
@@ -127,7 +129,9 @@ Add Enrollment Information
box, and then enter the time you want enrollment for your course to end in the **Enrollment End Time** box.
*Note: The Enrollment dates on this screen will reflect the current time zone in your browser, depending on your geography. Enrollment times for students will show as UTC on Edge.*
.. note::
The Enrollment dates on this screen will reflect the current time zone in your browser, depending on your geography. Enrollment times for students will show as UTC on Edge.
...
...
@@ -156,7 +160,9 @@ can use that includes placeholders, see :doc:`appendices/a`.
If your course has prerequisites, you can include that information in the course overview.
*Note: There is no save button. Studio automatically saves your changes.*
.. note::
There is no save button. Studio automatically saves your changes.
The following is example content for the **Course Overview** box:
...
...
@@ -191,7 +197,9 @@ You can create an About video that will appear on the **About** page for your co
4. In the **your YouTube video's ID** box, enter your video code. When you add the code, the video automatically appears in the field above the **your YouTube video's ID** box.
*Note: There is no save button. Studio automatically saves your changes.*
.. note::
There is no save button. Studio automatically saves your changes.
For example, your course introduction video appears as follows.
@@ -35,7 +35,9 @@ Create assignment types for the course and determine the weight of the student's
Each subsection in your course can be designated as one of the assignment types that you have specified in the grading policy. You can also specify a release date and a due date.
*Note: You can create problems in Studio without specifying that the subsection is an assignment type. However, problems do not count toward a student's grade unless you set the subsection as a graded assignment type.*
.. note::
You can create problems in Studio without specifying that the subsection is an assignment type. However, problems do not count toward a student's grade unless you set the subsection as a graded assignment type.
For more information on creating problems, see `Create a Problem <Create_Problem.html>`_ .
...
...
@@ -62,7 +64,9 @@ To set the thresholds for course grades:
2. Under **Overall Grade Range**, click and drag the dividing line between grade divisions to move each threshold up or down.
*Note: The default grade divisions are Pass and Fail. To add more grade divisions (such as A, B, C, or D), click the plus sign (+).*
.. note::
The default grade divisions are Pass and Fail. To add more grade divisions (such as A, B, C, or D), click the plus sign (+).
After you establish your grading rubric, you can create a graded assignment or a test for your students. To do this, you must first create a subsections and then set up grading for the subsection. This includes setting the assignment type, the assignment release date, and the due date.
*Note: When you set a due date, keep in mind that students will be in different time zones across the world. By default, the time zone appears as UTC-not the student's local time. If you tell your students an assignment is due at 5:00 PM, make sure to specify that the time is 5:00 PM UTC and point them to a time converter.*
.. note::
When you set a due date, keep in mind that students will be in different time zones across the world. By default, the time zone appears as UTC-not the student's local time. If you tell your students an assignment is due at 5:00 PM, make sure to specify that the time is 5:00 PM UTC and point them to a time converter.
Alternatively, you can :ref:`set a grace period<Set-Grace-Period>` for your assignments to cover any misunderstandings about time. For example, some classes have set a grace period of 1 day, 6 hours, and 1 minute. This grace period applies to the entire course.
...
...
@@ -205,4 +211,6 @@ To set the assignment type for a subsection:
.. image:: images/image153.png
*Note: If you change an assignment type name in the Grading page, make sure the assignment type names on the Course Outline still match.*
\ No newline at end of file
.. note::
If you change an assignment type name in the Grading page, make sure the assignment type names on the Course Outline still match.
@@ -27,7 +25,7 @@ Studio (http://studio.edge.edx.org) is our web-based course authoring tool. It i
**There is a workflow to getting started.**
**There is a workflow to getting started.** Here is a quick summary:
...
...
@@ -57,6 +55,10 @@ Studio (http://studio.edge.edx.org) is our web-based course authoring tool. It i
.. image:: images/image027.png
:width: 800
.. raw:: latex
\newpage %
*****************
Create an Account
...
...
@@ -115,6 +117,10 @@ e. Click to select I agree to the Terms of Service.
.. image:: images/image017.png
:width: 800
.. raw:: latex
\newpage %
*******************
Create a New Course
*******************
...
...
@@ -137,7 +143,9 @@ To create a new course:
1. Click **New Course.** A screen opens.
*Note: Enter your new course information carefully. This information becomes part of the URL for your course. To change the URL after the course is created, you must contact edX through the Help site (http://help.edge.edx.org). Additionally, because this information becomes part of your course URL, the total number of characters in the following three fields must be 65 or fewer.*
.. note::
Enter your new course information carefully. This information becomes part of the URL for your course. To change the URL after the course is created, you must contact edX through the Help site (http://help.edge.edx.org).Additionally, because this information becomes part of your course URL, the total number of characters in the following three fields must be 65 or fewer.
2. For **Course Name**, enter the title of your course. For example, the name may be “Sets, Maps and Symmetry Groups". Use title capitalization for the course title.
This version of the edX "Getting Started with Studio" help and pdf documentation is created using Sphinx 1.2b1 and LaTex. You, the user community, can help update and revise this documentation project in GitHub at ::
edx\edX-platform\userdocs\source
with a pull request that will need approval from an engineering contact at edX.
The edX contact for this documenation is mchang@edx.org