From 356b10c27142bc07c5106c772f9daeca7cd8efc3 Mon Sep 17 00:00:00 2001 From: Mark Hoeber Date: Fri, 17 Apr 2015 10:10:08 -0400 Subject: [PATCH] Update component templates for accessibility and content --- .../contentstore/features/component.py | 4 +- .../xmodule/templates/html/announcement.yaml | 31 +- .../xmodule/templates/html/latex_html.yaml | 14 +- .../problem/checkboxes_response.yaml | 58 +++- .../templates/problem/circuitschematic.yaml | 28 +- .../templates/problem/customgrader.yaml | 75 +++-- .../templates/problem/drag_and_drop.yaml | 58 ++-- .../templates/problem/formularesponse.yaml | 65 ++-- .../templates/problem/imageresponse.yaml | 42 ++- .../templates/problem/jsinput_response.yaml | 50 ++- .../templates/problem/latex_problem.yaml | 285 ++++++++++-------- .../templates/problem/multiplechoice.yaml | 79 +++-- .../templates/problem/numericalresponse.yaml | 106 +++---- .../templates/problem/optionresponse.yaml | 54 ++-- .../templates/problem/string_response.yaml | 63 ++-- 15 files changed, 594 insertions(+), 418 deletions(-) diff --git a/cms/djangoapps/contentstore/features/component.py b/cms/djangoapps/contentstore/features/component.py index 029dc01f87..818b5b2d77 100644 --- a/cms/djangoapps/contentstore/features/component.py +++ b/cms/djangoapps/contentstore/features/component.py @@ -55,9 +55,9 @@ def see_a_multi_step_component(step, category): if category == 'HTML': html_matcher = { 'Text': '\n \n', - 'Announcement': '

Words of encouragement! This is a short note that most students will read.

', + 'Announcement': '

Announcement Date

', 'Zooming Image Tool': '

Zooming Image Tool

', - 'E-text Written in LaTeX': '

Example: E-text page

', + 'E-text Written in LaTeX': '

Example: E-text page

', 'Raw HTML': '

This template is similar to the Text template. The only difference is', } actual_html = world.css_html(selector, index=idx) diff --git a/common/lib/xmodule/xmodule/templates/html/announcement.yaml b/common/lib/xmodule/xmodule/templates/html/announcement.yaml index 821d2a6ec6..a0f4b07e4e 100644 --- a/common/lib/xmodule/xmodule/templates/html/announcement.yaml +++ b/common/lib/xmodule/xmodule/templates/html/announcement.yaml @@ -2,22 +2,17 @@ metadata: display_name: Announcement data: | -

    -
  1. -

    September 21

    +

    To use this template, replace the example text with your own text.

    +

    When you add the component, be sure to select Settings + to specify a Display Name and other values that apply.

    +

    Announcement Date

    -
    -

    Words of encouragement! This is a short note that most students will read.

    -

    Anant Agarwal (6.002x Principal Instructor)

    -
    -

    Primary versus Secondary Updates:

    Unfortunately, the internet throws a lot of text at students, and they - do not read everything that they are given. However, many students do read all that they are - given, and so detailed explainations in this section will benefit the most concientious. - Any essential information should be extremely quickly summarized in the primary section for skimmers.

    -

    Star Forum Poster

    - Students appreciate knowing that the course staff is reading what they post, and one of several ways - that you can do this is by acknowledging the star posters in your announcements. -

    -
    -
    2. -
+
+

Short note that introduces the topic

+

Instructor's name

+
+

Heading for announcement 1

+

Announcement 1 text

+

Heading for announcement 2

+

Announcement 2 text

+ \ No newline at end of file diff --git a/common/lib/xmodule/xmodule/templates/html/latex_html.yaml b/common/lib/xmodule/xmodule/templates/html/latex_html.yaml index 9163b3e8b9..f82c60ed8d 100644 --- a/common/lib/xmodule/xmodule/templates/html/latex_html.yaml +++ b/common/lib/xmodule/xmodule/templates/html/latex_html.yaml @@ -4,18 +4,18 @@ metadata: source_code: | \subsection{Example of E-text in LaTeX} - It is very convenient to write complex equations in LaTeX. + You can write complex equations in LaTeX. \begin{equation} x = \frac{-b\pm\sqrt{b^2-4*a*c}}{2a} \end{equation} - Seize the moment. - data: | -

Example: E-text page

-

- It is very convenient to write complex equations in LaTeX. -

+

Example: E-text page

+

You can write complex equations in LaTeX.

+

When you add the component, be sure to select Settings + to specify a Display Name and other values that apply.

+

When editing this component, select Launch Latex Source Compiler to edit equations.

+

Then, in the equation editor, select Save and Compile to edX XML to see the equation in the component.

diff --git a/common/lib/xmodule/xmodule/templates/problem/checkboxes_response.yaml b/common/lib/xmodule/xmodule/templates/problem/checkboxes_response.yaml index ae62459820..144ff0358b 100644 --- a/common/lib/xmodule/xmodule/templates/problem/checkboxes_response.yaml +++ b/common/lib/xmodule/xmodule/templates/problem/checkboxes_response.yaml @@ -2,23 +2,49 @@ metadata: display_name: Checkboxes markdown: | - A checkboxes problem presents checkbox buttons for student input. Students can select more than one option presented. - >>Select the answer that matches<< + Checkbox problems allow learners to select multiple options. Learners can see all the options along with the problem text. + + When you add the problem, be sure to select Settings to specify a Display Name and other values that apply. - [x] correct - [ ] incorrect - [x] correct + You can use the following example problem as a model. + _____________________________________________________________________________ + + >>The following languages are in the Indo-European family:<< + [x] Urdu + [ ] Finnish + [x] Marathi + [x] French + [ ] Hungarian + + Note: Make sure you select all of the correct options—there may be more than one! + + [explanation] + Urdu, Marathi, and French are all Indo-European languages, while Finnish and Hungarian are in the Uralic family. + [explanation] data: | -

A checkboxes problem presents checkbox buttons for student input. Students can select more than one option presented.

-

Select the answer that matches

- - - correct - incorrect - correct - - - - +

Checkbox problems allow learners to select multiple options. Learners can see all the options along with the problem text.

+

When you add the component, be sure to select Settings + to specify a Display Name and other values that apply.

+

You can use the following example problem as a model.

+
+ The following languages are in the Indo-European family: + + + Urdu + Finnish + Marathi + French + Hungarian + + +
+

Note: Make sure you select all of the correct options—there may be more than one!

+ +
+

Explanation

+

Urdu, Marathi, and French are all Indo-European languages, while Finnish and Hungarian are in the Uralic family.

+
+ + \ No newline at end of file diff --git a/common/lib/xmodule/xmodule/templates/problem/circuitschematic.yaml b/common/lib/xmodule/xmodule/templates/problem/circuitschematic.yaml index 051dfe1912..edfdadce19 100644 --- a/common/lib/xmodule/xmodule/templates/problem/circuitschematic.yaml +++ b/common/lib/xmodule/xmodule/templates/problem/circuitschematic.yaml @@ -3,9 +3,22 @@ metadata: display_name: Circuit Schematic Builder markdown: !!null data: | - - Please make a voltage divider that splits the provided voltage evenly. - + +

+ Circuit schematic problems allow students to create virtual circuits by + arranging elements such as voltage sources, capacitors, resistors, and + MOSFETs on an interactive grid. The system evaluates a DC, AC, or + transient analysis of the circuit. +

+

+ For more information, see + + Circuit Schematic Builder Problem in Building and Running an edX Course.

+

When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.

+

You can use the following example problems as models.

+
+ Make a voltage divider that splits the provided voltage evenly.
+
+
+ Make a high-pass filter. -

Make a high pass filter

+

Explanation

-

A voltage divider that evenly divides the input voltage can be formed with two identically valued resistors, with the sampled voltage taken in between the two.

+

You can form a voltage divider that evenly divides the input voltage with two identically valued resistors, with the sampled voltage taken in between the two.

-

A simple high-pass filter without any further constaints can be formed by simply putting a resister in series with a capacitor. The actual values of the components do not really matter in order to meet the constraints of the problem.

+

You can form a simple high-pass filter without any further constraints by simply putting a resistor in series with a capacitor. The actual values of the components do not really matter in this problem.

 diff --git a/common/lib/xmodule/xmodule/templates/problem/customgrader.yaml b/common/lib/xmodule/xmodule/templates/problem/customgrader.yaml index ad2d05cbc9..edb62d1440 100644 --- a/common/lib/xmodule/xmodule/templates/problem/customgrader.yaml +++ b/common/lib/xmodule/xmodule/templates/problem/customgrader.yaml @@ -4,11 +4,32 @@ metadata: markdown: !!null data: | -

- A custom python-evaluated input problem accepts one or more lines of text input from the - student, and evaluates the inputs for correctness based on evaluation using a - python script embedded within the problem. +

+ In custom Python-evaluated input (also called "write-your-own-grader" + problems), the grader uses a Python script that you create and embed in + the problem to evaluate a learner's response or provide hints. These + problems can be any type. Numerical input and text input problems are + the most common write-your-own-grader problems.

+

+ You can use script tag format or answer tag format to create these problems. +

+

+ You can create custom Python-evaluated input problems that provide + partial credit or that randomize variables in the Python code. You can + also add images to the solution by using an HTML "img" tag. Note that + the "img" tag must be between the "div" tags that are inside the + "solution" tags, and that learners do not see these images until they + click the "Show Answer" button. +

+

For more information, see + Write-Your-Own-Grader Problem in Building and Running an edX Course. +

+

When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.

+

You can use the following example problem as a model.

+

______________________________________________________________________________

- -

Enter two integers which sum to 10:

- -
- - - -

Enter two integers which sum to 20:

- -
- - - - -
-

Explanation

-

Any set of integers on the line \(y = 10 - x\) and \(y = 20 - x\) satisfy these constraints.

-

You can also add images within the solution clause like so:

- -
- +
+ Enter two integers that sum to 10. + +
+ + +
+
+ Enter two integers that sum to 20. + +
+ + +
+ +
+

Explanation

+

Any set of integers on the line \(y = 10 - x\) and \(y = 20 - x\) satisfy these constraints.

+

To add an image to the solution, use an HTML "img" tag. Make sure to include alt text.

+ Description of image, with a primary goal of explaining its + relevance to the problem or concept being illustrated for someone + who is unable to see the image. +
+ diff --git a/common/lib/xmodule/xmodule/templates/problem/drag_and_drop.yaml b/common/lib/xmodule/xmodule/templates/problem/drag_and_drop.yaml index 6f087763df..bfdf72a1cc 100644 --- a/common/lib/xmodule/xmodule/templates/problem/drag_and_drop.yaml +++ b/common/lib/xmodule/xmodule/templates/problem/drag_and_drop.yaml @@ -4,22 +4,36 @@ metadata: markdown: !!null data: | - Here's an example of a "Drag and Drop" question set. Click and drag each word in the scrollbar below, up to the numbered bucket which matches the number of letters in the word. +

+ In drag and drop problems, students respond to a question by dragging text or objects to a specific location on an image. +

+

+ For more information, see + + Drag and Drop Problem in Building and Running an edX Course.

+

When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.

+

You can use the following example problems as models.

+

_____________________________________________________________________________

- - - - - - - - - - - - - - +

Simple Drag and Drop

+
+ Drag each word in the scrollbar to the bucket that matches the number of letters in the word. + + + + + + + + + + + + + +
+ correct_answer = { '1': [[70, 150], 121], '6': [[190, 150], 121], @@ -36,13 +50,12 @@ data: | correct = ['correct'] else: correct = ['incorrect'] - - + + - -

Drag and Drop with Outline

-

Please label hydrogen atoms connected with left carbon atom.

- +

Drag and Drop with Outline

+
+ Label the hydrogen atoms connected with the left carbon atom. @@ -58,7 +71,8 @@ data: | - +
+ correct_answer = [{ 'draggables': ['1', '2'], 'targets': ['t2', 't3', 't4' ], diff --git a/common/lib/xmodule/xmodule/templates/problem/formularesponse.yaml b/common/lib/xmodule/xmodule/templates/problem/formularesponse.yaml index 1e8477f796..8c12edda61 100644 --- a/common/lib/xmodule/xmodule/templates/problem/formularesponse.yaml +++ b/common/lib/xmodule/xmodule/templates/problem/formularesponse.yaml @@ -5,40 +5,53 @@ metadata: data: |

- A math expression input problem accepts a line of text representing a mathematical expression from the - student, and evaluates the input for equivalence to a mathematical expression provided by the - grader. Correctness is based on numerical sampling of the symbolic expressions. + In math expression input problems, learners enter text that represents a + mathematical expression into a field, and text is converted to a symbolic + expression that appears below that field. You can refer learners to + + Entering Mathematical and Scientific Expressions in the edX Guide for + Students for information about how to enter text into the field.

- The answer is correct if both the student provided response and the grader's mathematical - expression are equivalent to specified numerical tolerance, over a specified range of values for each - variable. + Math expression problems can include unknown variables and relatively + complicated symbolic expressions. The grader uses a numerical sampling to + determine whether the student’s response matches your math expression, to a + specified numerical tolerance. You must specify the allowed variables in the + expression as well as the range of values for each variable.

+

+ To create these problems, you use MathJax to change your plain text into + "beautiful math." For more information about how to use MathJax in Studio, + see + A Brief Introduction to MathJax in Studio in Building and Running an edx + Course. +

+

When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.

+

You can use the following example problems as models.

+

_____________________________________________________________________________

-

This kind of response checking can handle symbolic expressions, but places an extra burden - on the problem author to specify the allowed variables in the expression, and the - numerical ranges over which the variables must be sampled in order to test for correctness.

+

Write an expression for the product of \( R_1\), \( R_2\), and + the inverse of \( R_3\) .

+ + + + -

Give an equation for the relativistic energy of an object with mass m. Explicitly indicate multiplication with a * symbol.

- - -
E = + +

Let \( x\) be a variable, and let \( n\) be an arbitrary constant. + What is the derivative of \( x^n\)?

+ + + + + + -

The answer to this question is (R_1*R_2)/R_3.

- - - - - - -
-

Explanation

-

The mathematical summary of many of the theory of relativity developed by Einstein is that the amount of energy contained in a mass m is the mass time the speed of light squared.

-

As you can see with the formula entry, the answer is \(\frac{R_1*R_2}{R_3}\)

-
- diff --git a/common/lib/xmodule/xmodule/templates/problem/imageresponse.yaml b/common/lib/xmodule/xmodule/templates/problem/imageresponse.yaml index 8a9c344250..ab0589b165 100644 --- a/common/lib/xmodule/xmodule/templates/problem/imageresponse.yaml +++ b/common/lib/xmodule/xmodule/templates/problem/imageresponse.yaml @@ -4,19 +4,35 @@ metadata: markdown: !!null data: | -

- An image mapped input problem presents an image for the student. - Input is given by the location of mouse clicks on the image. - Correctness of input can be evaluated based on expected dimensions of a rectangle. -

-

Which animal shown below is a kitten?

+

+ In an image mapped input problem, also known as a "pointing on a picture" + problem, students click inside a defined region in an image. You define this + region by including coordinates in the body of the problem. You can define + one rectangular region, multiple rectangular regions, or one non-rectangular + region. For more information, see + Image Mapped Input + Problem in Building and Running an edx Course. +

+

When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.

+

You can use the following example problem as a model.

+

_____________________________________________________________________________

+ +
+ What country is home to the Great Pyramid of Giza as well as the cities + of Cairo and Memphis? Click the country on the map below. - + - -
-

Explanation

-

The animal on the right is a kitten. The animal on the left is a puppy, not a kitten.

-
- +
+ +
+

Explanation

+

Egypt is home to not only the Pyramids, Cairo, and Memphis, but also + the Sphinx and the ancient Royal Library of Alexandria.

+
+ + diff --git a/common/lib/xmodule/xmodule/templates/problem/jsinput_response.yaml b/common/lib/xmodule/xmodule/templates/problem/jsinput_response.yaml index d6fbc4b318..d0fa838090 100644 --- a/common/lib/xmodule/xmodule/templates/problem/jsinput_response.yaml +++ b/common/lib/xmodule/xmodule/templates/problem/jsinput_response.yaml @@ -3,37 +3,57 @@ metadata: display_name: Custom Javascript Display and Grading markdown: !!null data: | - + +

+ In these problems (also called custom JavaScript problems or JS Input + problems), you add a problem or tool that uses JavaScript in Studio. + Studio embeds the problem in an IFrame so that your students can + interact with it in the LMS. You can grade your students' work using + JavaScript and some basic Python, and the grading is integrated into the + edX grading system. +

+

+ The JS Input problem that you create must use HTML, JavaScript, and cascading + style sheets (CSS). You can use any application creation tool, such as the + Google Web Toolkit (GWT), to create your JS Input problem. +

+

+ For more information, see + + Custom JavaScript Problem in Building and Running an edX Course. +

+

JavaScript developers shoud also see + Custom JavaScript Applications in the edX Developer's Guide.

+

When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.

+

You can use the following example problem as a model.

+

_____________________________________________________________________________

+ -

- The shapes below can be selected (yellow) or unselected (cyan). - Clicking on them repeatedly will cycle through these two states. -

-

- If the cone is selected (and not the cube), a correct answer will be - generated after pressing "Check". Clicking on either "Check" or "Save" - will register the current state. -

+

In the following image, click the objects until the cone is yellow + and the cube is blue.

} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \subsection{Example show/hide explanation} - Extra explanations can be tucked away behind a "showhide" toggle flag: + You can provide additional information that only appears at certain times by including a "showhide" flag. - \edXshowhide{sh1}{More explanation}{This is a hidden explanation. It - can contain equations: $\alpha = \frac{2}{\sqrt{1+\gamma}}$ } + \edXshowhide{sh1}{More explanation}{This is a hidden explanation. It + can contain equations, such as $\alpha = \frac{2}{\sqrt{1+\gamma}}$ }. - This is some text after the showhide example. + This is additional text after the hidden explanation. markdown: !!null data: | - -

-

Example "option" problem

-

-

- Where is the earth?

-

+

If you have a problem that is already written in LaTeX, you can use this problem type to + easily convert your code into XML. After you paste your code into the LaTeX editor, + you only need to make a few minor adjustments.

+

For more information, see + + Problem Written in LaTeX in Building and Running an edX Course.

+

You can use the following example problems as models.

+

Example Option Problem

+
+ Which of the following countries celebrates its independence on August 15? +
- + -

-

-

Example "symbolic" problem

-

-

- What is Einstein's equation for the energy equivalent of a mass [mathjaxinline]m[/mathjaxinline]?

-

+

+ +
+

Explanation

+

India became an independent nation on August 15, 1947.

+
+ +
+

Example Multiple Choice Problem

+
+ Which of the following countries has the largest population? + + + Brazil + Germany + Indonesia + Russia + + +
+ +
+

Explanation

+

According to September 2014 estimates:

+

The population of Indonesia is approximately 250 million.

+

The population of Brazil is approximately 200 million.

+

The population of Russia is approximately 146 million.

+

The population of Germany is approximately 81 million.

+
+ +
+

Example Math Expression Problem

+
+ What is Einstein's equation for the energy equivalent of a mass [mathjaxinline]m[/mathjaxinline]? -

-

-

Example "numerical" problem

-

-

- Estimate the energy savings (in J/y) if all the people ([mathjaxinline]3\times 10^8[/mathjaxinline]) in the U. S. switched from U. S. code to low flow shower heads.

-

+

+
+

Example Numerical Problem

+
+ Estimate the energy savings (in J/y) if all the people ([mathjaxinline]3\times 10^8[/mathjaxinline]) in the U. S. switched from U. S. code to low-flow shower heads.

Energy saved =

+

 EJ/year

 -

 EJ/year

-

-

-

Example "multiple choice" problem

-

-

- What color is a banana?

-

- - - - Red - - - Green - - - Yellow - - - Blue - - - -

-

-

Example "string response" problem

-

-

- In what U.S. state is Detroit located?

-

- - +

+
+

Example Fill-in-the-Blank Problem

+
+ What was the first post-secondary school in China to allow both male and female students? + + National Central University + Nanjing University + -

-

- An explanation of the answer can be provided by using the edXsolution macro. Click on "Show Answer" to see the solution.

-

- - Answer: - Detroit is near Canada, but it is actually in the United States. - -

-

-

Example "custom response" problem

-

-

- This problem demonstrates the use of a custom python script used for checking the answer.

- -

- Enter a python list of two numbers which sum to 10, eg [9,1]:

-

- - - -

-

-

Example image

-

-

- Include image by using the edXxml macro:

-

- -

-

-

Example show/hide explanation

-

-

- Extra explanations can be tucked away behind a "showhide" toggle flag:

+
+ +
+

Explanation

+

Nanjing Higher Normal Institute first admitted female students in 1920.

+
+ +
+

Example Custom Python-Evaluated Input Problem

+ +
+ Enter two integers that sum to 10. + +
+ + +
+
+ Enter two integers that sum to 20. + +
+ + +
+ +
+

Explanation

+

Any set of integers on the line \(y = 10 - x\) and \(y = 20 - x\) satisfy these constraints.

+

To add an image to the solution, use an HTML "img" tag. Make sure to include alt text.

+ Description of image +
+ +
+

Example Image Mapped Input Problem

+
+ What country is home to the Great Pyramid of Giza as well as the cities + of Cairo and Memphis? Click the country on the map below. + + + +
+ +
+

Explanation

+

Egypt is home to not only the Pyramids, Cairo, and Memphis, but also + the Sphinx and the ancient Royal Library of Alexandria.

+
+ +
+

Example Hidden Explanation

+

You can provide additional information that only appears at certain times by including a "showhide" flag.

- +

- - + \ No newline at end of file diff --git a/common/lib/xmodule/xmodule/templates/problem/multiplechoice.yaml b/common/lib/xmodule/xmodule/templates/problem/multiplechoice.yaml index a222d19939..2aab5d17f9 100644 --- a/common/lib/xmodule/xmodule/templates/problem/multiplechoice.yaml +++ b/common/lib/xmodule/xmodule/templates/problem/multiplechoice.yaml @@ -2,40 +2,53 @@ metadata: display_name: Multiple Choice markdown: | - A multiple choice problem presents radio buttons for student input. Students can only select a single option presented. Multiple Choice questions have been the subject of many areas of research due to the early invention and adoption of bubble sheets. - - One of the main elements that goes into a good multiple choice question is the existence of good distractors. That is, each of the alternate responses presented to the student should be the result of a plausible mistake that a student might make. - - >>What Apple device competed with the portable CD player?<< - ( ) The iPad - ( ) Napster - (x) The iPod - ( ) The vegetable peeler - + Multiple choice problems allow learners to select only one option. Learners can see all the options along with the problem text. + + When you add the problem, be sure to select Settings to specify a Display Name and other values that apply. + + You can use the following example problem as a model. + _____________________________________________________________________________ + + >>Which of the following countries has the largest population?<< + ( ) Brazil + ( ) Germany + (x) Indonesia + ( ) Russia + [explanation] - The release of the iPod allowed consumers to carry their entire music library with them in a format that did not rely on fragile and energy-intensive spinning disks. + According to September 2014 estimates: + The population of Indonesia is approximately 250 million. + The population of Brazil is approximately 200 million. + The population of Russia is approximately 146 million. + The population of Germany is approximately 81 million. [explanation] + data: | -

- A multiple choice problem presents radio buttons for student - input. Students can only select a single option presented. Multiple Choice questions have been the subject of many areas of research due to the early invention and adoption of bubble sheets.

-

One of the main elements that goes into a good multiple choice question is the existence of good distractors. That is, each of the alternate responses presented to the student should be the result of a plausible mistake that a student might make. -

- -

What Apple device competed with the portable CD player?

- - - The iPad - Napster - The iPod - The vegetable peeler - - - -
-

Explanation

-

The release of the iPod allowed consumers to carry their entire music library with them in a format that did not rely on fragile and energy-intensive spinning disks.

-
- - +

Multiple choice problems allow learners to select only one option. + Learners can see all the options along with the problem text.

+

When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.

+

You can use the following example problem as a model.

+
+ Which of the following countries has the largest population? + + + Brazil + Germany + Indonesia + Russia + + +
+ +
+

Explanation

+

According to September 2014 estimates:

+

The population of Indonesia is approximately 250 million.

+

The population of Brazil is approximately 200 million.

+

The population of Russia is approximately 146 million.

+

The population of Germany is approximately 81 million.

+
+ + \ No newline at end of file diff --git a/common/lib/xmodule/xmodule/templates/problem/numericalresponse.yaml b/common/lib/xmodule/xmodule/templates/problem/numericalresponse.yaml index 2cf092223e..8d886d3b30 100644 --- a/common/lib/xmodule/xmodule/templates/problem/numericalresponse.yaml +++ b/common/lib/xmodule/xmodule/templates/problem/numericalresponse.yaml @@ -2,66 +2,66 @@ metadata: display_name: Numerical Input markdown: | - A numerical input problem accepts a line of text input from the student, and evaluates the input for correctness based on its numerical value. + In a numerical input problem, learners enter numbers or a specific and relatively simple mathematical expression. Learners enter the response in plain text, and the system then converts the text to a symbolic expression that learners can see below the response field. - The answer is correct if it is within a specified numerical tolerance of the expected answer. + The system can handle several types of characters, including basic operators, fractions, exponents, and common constants such as "i". You can refer learners to "Entering Mathematical and Scientific Expressions" in the edX Guide for Students for more information. - >>Enter the numerical value of Pi:<< - = 3.14159 +- .02 - - >>Enter the approximate value of 502*9:<< - = 4518 +- 15% + When you add the problem, be sure to select Settings to specify a Display Name and other values that apply. - >>Enter the number of fingers on a human hand<< - = 5 + You can use the following example problems as models. + _____________________________________________________________________________ - [explanation] - Pi, or the the ratio between a circle's circumference to its diameter, is an irrational number known to extreme precision. It is value is approximately equal to 3.14. + >>How many miles away from Earth is the sun? Use scientific notation to answer.<< - Although you can get an exact value by typing 502*9 into a calculator, the result will be close to 500*10, or 5,000. The grader accepts any response within 15% of the true value, 4518, so that you can use any estimation technique that you like. + = 9.3*10^6 + or= 9.296*10^6 - If you look at your hand, you can count that you have five fingers. - [explanation] + >>The square of what number is -100?<< + + = 10*i + + [explanation] + The sun is 93,000,000, or 9.3*10^6, miles away from Earth. + -100 is the square of 10 times the imaginary number, i. + [explanation] data: | - -

- A numerical input problem accepts a line of text input from the - student, and evaluates the input for correctness based on its - numerical value. -

+ -

- The answer is correct if it is within a specified numerical tolerance - of the expected answer. -

- +

In a numerical input problem, learners enter numbers or a specific and + relatively simple mathematical expression. Learners enter the response in + plain text, and the system then converts the text to a symbolic expression + that learners can see below the response field.

-

Enter the numerical value of Pi: - - - - -

-

Enter the approximate value of 502*9: - - - - -

+

The system can handle several types of characters, including basic + operators, fractions, exponents, and common constants such as i. You can + refer learners to + + Entering Mathematical and Scientific Expressions in the edX Guide for + Students for information about how to enter text into the field.

+

When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.

-

Enter the number of fingers on a human hand: - - - -

- -
-

Explanation

-

Pi, or the the ratio between a circle's circumference to its diameter, is an irrational number known to extreme precision. It is value is approximately equal to 3.14.

-

Although you can get an exact value by typing 502*9 into a calculator, the result will be close to 500*10, or 5,000. The grader accepts any response within 15% of the true value, 4518, so that you can use any estimation technique that you like.

-

If you look at your hand, you can count that you have five fingers.

-
- - +

You can use the following example problems as models.

+

_____________________________________________________________________________

+ +
+ How many miles away from Earth is the sun? Use scientific notation to answer. + + + +
+ +
+ The square of what number is -100? + + + +
+ +
+

Explanation

+

The sun is 93,000,000, or 9.3*10^6, miles away from Earth.

+

-100 is the square of 10 times the imaginary number, i.

+
+ + \ No newline at end of file diff --git a/common/lib/xmodule/xmodule/templates/problem/optionresponse.yaml b/common/lib/xmodule/xmodule/templates/problem/optionresponse.yaml index 1e661fd0af..25de5fa3fc 100644 --- a/common/lib/xmodule/xmodule/templates/problem/optionresponse.yaml +++ b/common/lib/xmodule/xmodule/templates/problem/optionresponse.yaml @@ -2,35 +2,39 @@ metadata: display_name: Dropdown markdown: | - Dropdown problems give a limited set of options for students to respond with, and present those options in a format that encourages them to search for a specific answer rather than being immediately presented with options from which to recognize the correct answer. + Dropdown problems allow learners to select only one option from a list of options. - The answer options and the identification of the correct answer is defined in the optioninput tag. + When you add the problem, be sure to select Settings to specify a Display Name and other values that apply. - >>Translation between Dropdown and __________ is extremely straightforward:<< + You can use the following example problem as a model. - [[(Multiple Choice), Text Input, Numerical Input, External Response, Image Response]] + _____________________________________________________________________________ - [explanation] - Multiple Choice also allows students to select from a variety of pre-written responses, although the format makes it easier for students to read very long response options. Dropdowns also differ slightly because students are more likely to think of an answer and then search for it rather than relying purely on recognition to answer the question. - [explanation] + >>Which of the following countries celebrates its independence on August 15?<< + + [[(India), Spain, China, Bermuda]] + + [explanation] + India became an independent nation on August 15, 1947. + [explanation] data: | -

Dropdown problems give a limited set of options for students to respond with, and present those options - in a format that encourages them to search for a specific answer rather than being immediately presented with options from which to recognize the correct answer.

- -

- The answer options and the identification of the correct answer is defined in the optioninput tag. -

-

Translation between Dropdown and __________ is extremely straightforward: - - - - -

- -
-

Explanation

-

Multiple Choice also allows students to select from a variety of pre-written responses, although the format makes it easier for students to read very long response options. Optionresponse also differs slightly because students are more likely to think of an answer and then search for it rather than relying purely on recognition to answer the question.

-
- +

Dropdown problems allow learners to select only one option from a list of options.

+

When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.

+

You can use the following example problem as a model.

+
+ Which of the following countries celebrates its independence on August 15? +
+ + + +
+ +
+

Explanation

+

India became an independent nation on August 15, 1947.

+
+ + diff --git a/common/lib/xmodule/xmodule/templates/problem/string_response.yaml b/common/lib/xmodule/xmodule/templates/problem/string_response.yaml index 008a6bf647..701934f40e 100644 --- a/common/lib/xmodule/xmodule/templates/problem/string_response.yaml +++ b/common/lib/xmodule/xmodule/templates/problem/string_response.yaml @@ -2,38 +2,45 @@ metadata: display_name: Text Input markdown: | - A text input problem accepts a line of text from the student, and evaluates the input for correctness based on an expected answer. - - The answer is correct if it matches every character of the expected answer. This can be a problem with international spelling, dates, or anything where the format of the answer is not clear. - - >>Which US state has Lansing as its capital?<< - - = Michigan + In text input problems, also known as "fill-in-the-blank" problems, learners enter text into a response field. The text can include letters and characters such as punctuation marks. The text that the learner enters must match your specified answer text exactly. You can specify more than one correct answer. Learners must enter a response that matches one of the correct answers exactly. + When you add the problem, be sure to select Settings to specify a Display Name and other values that apply. + + You can use the following example problem as a model. + _____________________________________________________________________________ + + >>What was the first post-secondary school in China to allow both male and female students?<< + + = Nanjing Higher Normal Institute + or= National Central University + or= Nanjing University [explanation] - Lansing is the capital of Michigan, although it is not Michigan's largest city, or even the seat of the county in which it resides. + Nanjing Higher Normal Institute first admitted female students in 1920. [explanation] + data: | -

- - A text input problem accepts a line of text from the - student, and evaluates the input for correctness based on an expected - answer. -

-

- The answer is correct if it matches every character of the expected answer. This can be a problem with international spelling, dates, or anything where the format of the answer is not clear. -

- -

Which US state has Lansing as its capital?

- - - - -
-

Explanation

-

Lansing is the capital of Michigan, although it is not Michigan's largest city, or even the seat of the county in which it resides.

-
- +

In text input problems, also known as "fill-in-the-blank" problems, + learners enter text into a response field. The text that the learner enters + must match your specified answer text exactly. You can specify more than + one correct answer. Learners must enter a response that matches one of the + correct answers exactly.

+

When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.

+

You can use the following example problem as a model.

+
+ What was the first post-secondary school in China to allow both male and female students? + + National Central University + Nanjing University + + +
+ +
+

Explanation

+

Nanjing Higher Normal Institute first admitted female students in 1920.

+
+