Commit 8100e38f by Mark Hoeber

edX Course Authors Doc Reorganization

parent 16523b99
.. raw:: latex
\newpage %
.. _Appendix A:
.. _A Template For Course Overview:
========================================
APPENDIX A-Template For Course Overview
A Template For Your Course Overview
========================================
......
.. raw:: latex
\newpage %
.. _Appendix B:
===========================================
APPENDIX B: Code for Dynamic HTML Schedule
Code for Dynamic HTML Schedule
===========================================
::
.. code-block:: html
<div class= "syllabus">
......
......@@ -29,7 +29,7 @@ To set the grade range, from the **Settings** menu, select **Grading**.
The control for the grade range is at the top of the Grading page.
.. image:: Images/grade_range.png
.. image:: ../Images/grade_range.png
:width: 800
:alt: Image of the Grade Range control
......@@ -42,7 +42,7 @@ You use the grade range control to change these settings:
A new grade is added to the range between the existing grades. For example, if you add a grade in the default setting,
the grade range changes to **F** (0 to 50), **B** (50 to 75), and **A** (75 to 100):
.. image:: Images/grade_range_b.png
.. image:: ../Images/grade_range_b.png
:width: 800
:alt: Image of an altered Grade Range control
......@@ -176,13 +176,13 @@ You set the grading policy for the subsection from two places:
From the course outline, click the checkmark next to the subsection. Then select a grading policy from the popup menu:
.. image:: Images/course_outline_set_grade.png
.. image:: ../Images/course_outline_set_grade.png
:width: 600
:alt: Image of the assignment type for a subsection
From the subsection page, click the text next to the **Graded as** label, then select a grading policy from the popup menu:
.. image:: Images/subsection_set_grade.png
.. image:: ../Images/subsection_set_grade.png
:width: 600
:alt: Image of the assignment type on the subsection page
......@@ -205,7 +205,7 @@ You can also :ref:`Set the Grace Period` for your assignments to cover any misun
Students see the due date in the course accordian under the subsection title. For example:
.. image:: Images/Subsection_due_date.png
.. image:: ../Images/Subsection_due_date.png
:alt: Image of subsection due dates in the course accordian
There are several problems in this subsection, all due November 3, 2013 at 23:30 UTC.
......@@ -220,7 +220,7 @@ The Student View of Grades
**************************
Once a grading policy is in place, students can view both their problem scores and the percent completed and current grade in the **Progress** tab for the course.
.. image:: Images/Progress_tab.png
.. image:: ../Images/Progress_tab.png
:width: 800
:alt: Image of the student Progress tab
......
.. _Building a Course Index:
##########################
Building a Course
##########################
.. toctree::
:maxdepth: 2
create_new_course
establish_grading_policy
organizing_course
export_import_course
course_overview_template
dynamic_html_schedule
......@@ -33,12 +33,12 @@ To open the course outline, on the **Content** menu, click **Outline**.
The following image shows the different elements of a course outline:
.. image:: Images/Course_Outline.gif
.. image:: ../Images/Course_Outline.png
:alt: Image of the course outline, with callouts for sections, subsection, and units
The following image shows the way this course content appears in the LMS:
.. image:: Images/Course_Outline_LMS.gif
.. image:: ../Images/Course_Outline_LMS.png
:alt: Image of sections from the student's point of view
.. _Sections:
......@@ -87,7 +87,7 @@ You add and delete subsections from the **Course Outline** page. You edit a subs
On the page for the subsection, you can see all the units in the subsection.
.. image:: Images/Subsection.gif
.. image:: ../Images/subsection.png
:alt: Image of the subsection page
You can also do the following.
......@@ -116,7 +116,7 @@ Subsections are divided into units. A unit, in turn, contains one or more compon
In the LMS, each unit in the subsection appears as a link on the course ribbon at the top of the page. The following image shows a subsection that has eight units:
.. image:: Images/Units_LMS.gif
.. image:: ../Images/Units_LMS.png
:alt: Image of units from a student's point of view
The titles in the pop-up dialog, in white text on a black background, are the display names of the components in that unit.
......@@ -153,7 +153,7 @@ A component is the part of a unit that contains your actual course content. A un
A student can view the name of all components in a unit by hovering over the unit in the ribbon at the top of the page.
.. image:: Images/ComponentNames_CourseRibbon.gif
.. image:: ../Images/ComponentNames_CourseRibbon.png
:alt: Image of the component list for a unit
By default, Studio includes four types of components.
......@@ -165,7 +165,7 @@ By default, Studio includes four types of components.
To add a component to the unit, click the component type that you want under **Add New Component**.
.. image:: Images/AddNewComponent.gif
.. image:: ../Images/AddNewComponent.png
:alt: Image of adding a new component
For more information, see the documentation for the specific component type that you want:
......@@ -183,7 +183,7 @@ You can edit a component only if the unit that contains it is Private, or if you
When you can edit the component, the Edit icon and the Display Name appear in the component header:
.. image:: Images/unit-edit.png
.. image:: ../Images/unit-edit.png
:alt: Image of a unit with Edit icon circled
Click the Edit icon. Then follow instructions for the type of component you are editing.
......@@ -200,7 +200,7 @@ To set the display name for a component:
#. Click **Settings**.
#. Edit the **Display Name** field.
.. image:: Images/display-name.png
.. image:: ../Images/display-name.png
:alt: Image of the Display Name field for a component.
4. Click **Save**.
......@@ -217,7 +217,7 @@ When you duplicate a component, a new copy of that component is added directly b
When you can duplicate the component, the Duplicate icon appears in the component header:
.. image:: Images/unit-dup.png
.. image:: ../Images/unit-dup.png
:alt: Image of a unit with Duplicate icon circled
......@@ -233,7 +233,7 @@ You can delete a component only if the unit that contains it is Private, or if y
When you can delete the component, the Delete icon appears in the component header:
.. image:: Images/unit-delete.png
.. image:: ../Images/unit-delete.png
:alt: Image of a unit with Delete icon circled
Click the Delete icon. Then follow instructions for the type of component you are editing.
......@@ -248,10 +248,10 @@ You can reorganize your course by dragging and dropping sections, subsections, u
To move an element, hover over the element handle on the right side of the screen until the mouse pointer changes to a four-headed arrow. Then, click and drag the element to the location that you want.
.. image:: Images/DragAndDropExample.gif
.. image:: ../Images/DragAndDropExample.png
:alt: Image of the course outline, with the handle for a unit selected for drag and drop
When you move an element, a blue line indicates where the element will land when you release the mouse.
.. image:: Images/DragAndDrop_BlueLine.gif
.. image:: ../Images/DragAndDrop_BlueLine.png
:alt: Image of the course outline, with a unit being dragged to a different location
\ No newline at end of file
......@@ -10,8 +10,36 @@ Change Log
* - Date
- Change
* - 03/17/14
- Reorganized this document into major sections:
* :ref:`Getting Started Index`
* :ref:`Building a Course Index`
* :ref:`Creating Course Content Index`
* :ref:`Working with Problems Index`
* :ref:`Releasing Your Course Index`
* :ref:`Running Your Course Index`
* :ref:`Information for Your Students Index`
* - 03/10/14
- Added information about setting up your course summary page to :ref:`The Course Start Date`, :ref:`The Course End Date`, :ref:`Add a Course Image`, :ref:`Add a Course Video`, and :ref:`Describe Your Course`.
- Added information about setting up your course summary page to
* :ref:`The Course Start Date`
* :ref:`The Course End Date`
* :ref:`Add a Course Image`
* :ref:`Add a Course Video`
* :ref:`Describe Your Course`
* - 02/25/14
- Updated :ref:`Add Files to a Course` section to include new External URL feature.
* -
......
......@@ -37,7 +37,7 @@ master_doc = 'index'
# General information about the project.
project = u'Building a Course with edX Studio'
project = u'Building and Running an edX Course'
copyright = u'2014, edX'
# The short X.Y version.
......
......@@ -37,12 +37,12 @@ For more information on Public and Private Units, see :ref:`Public and Private U
#. Under **Add New Component**, click the **discussion** icon.
.. image:: Images/NewComponent_Discussion.png
.. image:: ../Images/NewComponent_Discussion.png
:alt: Image of the adding a new discussion component
The Discussion component is added:
.. image:: Images/EditDiscussionComponent.png
.. image:: ../Images/EditDiscussionComponent.png
:alt: Image of the discussion component with the Edit button circled
......@@ -50,7 +50,7 @@ For more information on Public and Private Units, see :ref:`Public and Private U
The Discussion component editor opens.
.. image:: Images/DiscussionComponentEditor.png
.. image:: ../Images/DiscussionComponentEditor.png
:alt: Image of the discussion component editor
#. Follow the guidelines in the editor to fill in the **Category**, **Display Name**, and **Subcategory**.
......@@ -65,7 +65,7 @@ A Student's View of the Discussion
For students, Discussion component names appear in the course ribbon at the top of the page:
.. image:: Images/DiscussionComponent_LMS_Ribbon.png
.. image:: ../Images/DiscussionComponent_LMS_Ribbon.png
:alt: Image of a unit from a student's point of view with the component list showing a discussion component
The Discussion space appears under other components in the unit.
......@@ -75,13 +75,13 @@ and a blue **New Post** button on the right.
In the following example, the Discussion component follows Video and HTML components:
.. image:: Images/DiscussionComponent_LMS.png
.. image:: ../Images/DiscussionComponent_LMS.png
:alt: Image of a video component followed by a discussion component
In the **Discussion** tab at the top of the page,
students can find the category and subcategory of the discussion in the left pane.
.. image:: Images/DiscussionComponent_Forum.png
.. image:: ../Images/DiscussionComponent_Forum.png
:alt: Image of the discussion page from a student's point of view
......@@ -31,14 +31,14 @@ The HTML Component User Interface
When you create a new HTML component, you work with the HTML component editor. The editor has two views: **Visual view** and **HTML view.** To switch between Visual view and HTML view, click the tab in the upper-right corner of the component editor.
.. image:: Images/HTMLEditorTabs.gif
.. image:: ../Images/HTMLEditorTabs.png
:alt: Image of the HTML component editor, with the Visual and HTML tabs circled
- **Visual view** provides a “what you see is what you get” (WYSIWYG) editor that allows you to format text by clicking the formatting buttons at the top of the editor. By default, every HTML component opens in Visual view.
Visual view includes the following formatting buttons.
.. image:: Images/HTML_VisualView_Toolbar.gif
.. image:: ../Images/HTML_VisualView_Toolbar.png
:alt: Image of the HTML visual editor, with callouts for formatting buttons
#. Select a formatting style, such as heading 1, heading 2, or paragraph.
......@@ -56,12 +56,12 @@ When you create a new HTML component, you work with the HTML component editor. T
Visual view shows your content the way it will appear in the LMS. The following is the LMS rendition of the HTML component above.
.. image:: Images/HTMLComponent_VisualView_LMS.gif
.. image:: ../Images/HTMLComponent_VisualView_LMS.png
:alt: Image of the visual view of the HTML component
- **HTML view** allows you to edit HTML code directly.
.. image:: Images/HTML_HTMLView.gif
.. image:: ../Images/HTML_HTMLView.png
:alt: Image of the HTML code view of the HTML component
.. note:: If you're in HTML view, you can always switch to Visual view to make sure your content looks the way you expect. For example, we recommend that you do this if you add an image or a link to an HTML component.
......@@ -76,7 +76,7 @@ To create an HTML component:
1. Under **Add New Component**, click **html**.
.. image:: Images/NewComponent_HTML.gif
.. image:: ../Images/NewComponent_HTML.png
:alt: Image of adding a new HTML component
2. In the list that appears, click **Text**.
......@@ -85,14 +85,14 @@ To create an HTML component:
An empty component appears at the bottom of the unit.
.. image:: Images/HTMLComponent_Edit.png
.. image:: ../Images/HTMLComponent_Edit.png
:alt: Image of an empty HTML component
3. In the empty component, click **Edit**.
The HTML component editor opens in Visual view.
.. image:: Images/HTMLEditor.gif
.. image:: ../Images/HTMLEditor.png
:alt: Image of the HTML component Visual view
4. Enter the text and formatting that you want, either by using the formatting buttons in Visual view or by manually adding HTML tags in HTML view.
......@@ -117,7 +117,7 @@ Add a Link in an HTML Component
To add a link to a website, course unit, or file in an HTML component, you'll work with the **Insert/Edit Link** dialog box.
.. image:: /Images/HTML_Insert-EditLink_DBox.gif
.. image:: ../Images/HTML_Insert-EditLink_DBox.png
:alt: Image of the Insert/Edit Link dialog box
For more information, see:
......@@ -140,7 +140,7 @@ To add a link to a website:
#. In the **Insert/Edit Link** dialog box, enter the URL of the website that you want in the **Link URL** field.
.. image:: Images/HTML_Insert-EditLink_Website.gif
.. image:: ../Images/HTML_Insert-EditLink_Website.png
:alt: Image of the Insert/Edit Link dialog box
#. If you want the link to open in a new window, click the drop-down arrow next to the **Target** field, and then select **Open Link in a New Window**. If not, you can leave the default value.
......@@ -160,7 +160,7 @@ You can add a link to a course unit in an HTML component.
#. Obtain the unit identifier of the unit you're linking to. To do this, open the unit page in Studio, and copy the unit ID from the **Unit Identifier** field under **Unit Location** in the right pane.
.. image:: /Images/UnitIdentifier.png
.. image:: ../Images/UnitIdentifier.png
:alt: Image of the unit page with the unit identifier circled
#. Open the HTML component where you want to add the link.
......@@ -176,7 +176,7 @@ You can add a link to a course unit in an HTML component.
Make sure to replace <unit identifier> (including the brackets) with the unit
identifier that you copied in step 2, and make sure to include both forward slashes (/).
.. image:: /Images/HTML_Insert-EditLink_CourseUnit.gif
.. image:: ../Images/HTML_Insert-EditLink_CourseUnit.png
:alt: Image of the Inser/Edit Link dialog box with a link to a unit identifier
#. If you want the link to open in a new window, click the drop-down arrow next to
......@@ -196,12 +196,14 @@ You can add a link in an HTML component to any file you've uploaded for the cour
#. On the **Files & Uploads** page, copy the **Embed URL** of the file.
.. image:: Images/HTML_Link_File.png
.. image:: ../Images/HTML_Link_File.png
:alt: Image of Files and Uploads page with the URL field circled
.. note:: You must use the **Embed URL** to link to the file, not the **External URL**.
2. Select the text that you want to make into the link.
#. Click the link icon in the toolbar.
......@@ -212,8 +214,8 @@ You can add a link in an HTML component to any file you've uploaded for the cour
Make sure to include both forward slashes (/).
.. image:: /Images/HTML_Insert-EditLink_File.gif
:alt: Image of the Insert/Edit Link dialog box with a link to a file
.. image:: ../Images/HTML_Insert-EditLink_File.png
:alt: Image of the Inser/Edit Link dialog box with a link to a file
#. If you want the link to open in a new window, click the drop-down arrow next to
the **Target** field, and then select **Open Link in a New Window**. If not, you can leave the default value.
......@@ -239,7 +241,7 @@ To add an image, you'll need the URL of the image that you uploaded to the cours
#. On the **Files & Uploads** page, copy the **Embed URL** of the image that you want.
.. image:: Images/image_link.png
.. image:: ../Images/image_link.png
:alt: Image of the Files & Upload page with the Embed URL for the image circled
.. note:: You must use the **Embed URL** to add the image, not the **External URL**.
......@@ -252,7 +254,7 @@ To add an image, you'll need the URL of the image that you uploaded to the cours
Make sure to include both forward slashes (/).
.. image:: /Images/HTML_Insert-Edit_Image.png
.. image:: ../Images/HTML_Insert-Edit_Image.png
:alt: Image of the Insert/Edit Image dialog box with a link to a file
4. Enter alternative text in the Image Description field. See :ref:`Best Practices for Describing Images` for more information.
......@@ -265,6 +267,8 @@ To add an image, you'll need the URL of the image that you uploaded to the cours
.. note:: When you add the image URL in the format ``/static/FileName.type``, then later reopen the **Insert/Edit Image** dialog box, you see that the URL changes to ``/c4x/edX/Course-name/asset/FileName.type``. This URL is OK and you do not need to change it. In the HTML view, the URL appears as ``/static/FileName.type``.
``<p><img src="/static/GreatLakes.png" alt="Map of the Great Lakes" /></p>``
.. _Import LaTeX Code:
......@@ -275,7 +279,7 @@ Import LaTeX Code into an HTML Component
You can import LaTeX code into an HTML component. You might do this, for example, if you want to create "beautiful math" such as the following.
.. image:: Images/HTML_LaTeX_LMS.gif
.. image:: ../Images/HTML_LaTeX_LMS.png
:alt: Image of math formulas created with LaTeX
.. warning:: The LaTeX processor that Studio uses to convert LaTeX code to XML is a third-party tool. We recommend that you use this feature with caution. If you do use it, make sure to work with your PM.
......@@ -295,12 +299,12 @@ To create an HTML component that contains LaTeX code:
#. Click **Edit** to open the new component. The component editor opens.
.. image:: Images/latex_component.png
.. image:: ../Images/latex_component.png
:alt: Image of the HTML component editor with the Latex compiler.
4. In the componenent editor, click **Launch Latex Source Compiler**. The Latex editor opens.
.. image:: Images/HTML_LaTeXEditor.gif
.. image:: ../Images/HTML_LaTeXEditor.png
:alt: Image of the HTML component editor with the Latex compiler.
#. Write Latex code as needed. You can also upload a Latex file into the editor from your computer by clicking **Upload** in the bottom right corner.
......@@ -309,7 +313,7 @@ To create an HTML component that contains LaTeX code:
The component editor closes, and the unit page opens. You can see the way your LaTeX content looks.
.. image:: Images/HTML_LaTeX_CompEditor.png
.. image:: ../Images/HTML_LaTeX_CompEditor.png
:alt: Image of the LaTeX component
#. On the unit page, click **Preview** to verify that your content looks the way you want it to in the LMS.
......
......@@ -95,7 +95,7 @@ In addition to your .srt file, you can provide other transcripts with your video
If you provide transcripts for students to download, a **Download transcript** button appears under the video. Students can then select either **SubRip (.srt) file** or **Text (.txt) file** to download the .srt or .txt transcript.
.. image:: Images/transcript-download.png
.. image:: ../Images/transcript-download.png
.. note:: Some past courses have used .sjson files for video transcripts. If transcripts in your course uses this format, see :ref:`Steps for sjson files`. We don't recommend that you use .sjson files.
......@@ -141,7 +141,7 @@ Step 4. Create a Video Component
#. When the new video component appears, click **Edit**. The video editor opens to the **Basic** tab.
.. image:: Images/VideoComponentEditor.gif
.. image:: ../Images/VideoComponentEditor.png
:alt: Image of the video component editor
You'll replace the default values with your own.
......@@ -251,7 +251,7 @@ You can provide transcripts for your video in other languages. To do this, you'l
#. In the box on the right, enter the URL for the language transcript file you uploaded to the **Files & Uploads** page. For example, you might enter **/static/Video1_Spanish.srt** or **/static/Video1_Russian.srt**.
.. image:: /Images/TranscriptTranslations.png
.. image:: ../Images/TranscriptTranslations.png
:alt: Image of Transcript Translations fields
.. note:: Make sure that all your transcript file names are unique to each video and language. If you use the same transcript name in more than one Video component, the same transcript will play for each video. To avoid this problem, you could name your foreign language transcript files according to the video's file name and the transcript language.
......
.. _Creating Course Content Index:
##########################
Creating Course Content
##########################
.. toctree::
:maxdepth: 2
accessibility
create_html_component
create_video
create_discussion
......@@ -49,13 +49,13 @@ To get started, you register your account on edX.org_ and Edge_.
* For edX.org, go to the `registration page <https://courses.edx.org/register>`_:
.. image:: Images/edx_registration.png
.. image:: ../Images/edx_registration.png
:alt: Image of the edX.org registration page
* For Edge, go to https://edge.edx.org and click **Register**:
.. image:: Images/edge_register.png
.. image:: ../Images/edge_register.png
:alt: Image of the Edge registration page
Make sure to check both **I agree to the Terms of Service** and **I agree to the Honor Code**.
......@@ -83,7 +83,7 @@ To get started, you register your account on edX.org_ and Edge_.
3. Click the link in the e-mail to complete the activation. When you see the following page, your account has been activated:
.. image:: Images/activation_screen.png
.. image:: ../Images/activation_screen.png
:alt: Image of the Activation page
......@@ -116,12 +116,12 @@ The process to reset your password on edX.org and Edge is the same.
#. In the account information pane in the upper left corner, click **Reset Password**.
.. image:: Images/dashboard-password-reset.png
.. image:: ../Images/dashboard-password-reset.png
:alt: Image with the Reset Password link highlighted
A dialog box opens confirming that a message has been sent to your email address.
.. image:: Images/password-email-dialog.png
.. image:: ../Images/password-email-dialog.png
:alt: Image with the Reset Password link highlighted
3. When you receive the following e-mail message, click the link in the message::
......@@ -142,7 +142,7 @@ The process to reset your password on edX.org and Edge is the same.
4. When the following dialog box opens, enter your new password in both fields, and then click **Change My Password**:
.. image:: Images/reset_password.png
.. image:: ../Images/reset_password.png
:alt: Image of the Reset Password dialog box
.. note:: Your password can be any string.
......
......@@ -39,7 +39,7 @@ You use Studio directly through your browser. You do not need any additional sof
Use Studio on Edge
******************
You can use Studio_ on Edge_ to build your own courses.
You can use Studio_ on Edge to build your own courses.
Go to: https://studio.edge.edx.org. Sign in with the account you created on Edge.
......@@ -52,6 +52,7 @@ You must then request access to create courses:
EdX then evaluates your request. When course creation permissions are granted, you receive an email message.
.. _Studio: https://studio.edge.edx.org
.. _Edge: http://edge.edx.org
.. _Create Your First Course:
......@@ -63,14 +64,14 @@ When you receive notice that you can create courses, log in to Studio_.
You see the following page:
.. image:: Images/first_course.png
.. image:: ../Images/first_course.png
:width: 600
:alt: Image of the Studio home page where you create your first course
#. Click **Create Your First Course**.
#. Enter course information as needed and click **Create**.
.. image:: Images/new_course_info.png
.. image:: ../Images/new_course_info.png
:width: 600
:alt: Image of the Create New Course page
......@@ -103,7 +104,7 @@ In the Course Outline in Studio, click **View Live**. The course opens on Edge.
You can also go directly to Edge_. Log in if prompted. You see the course you just created listed:
.. image:: Images/new_course.png
.. image:: ../Images/new_course.png
:width: 600
:alt: Image of the Edge Dashboard
......
......@@ -135,7 +135,7 @@ C
**Custom Response Problem**
A custom response problem evaluates text responses from students using an embedded Python script. These problems are also called "write-your-own-grader" problems. For more information, see :ref:`Custom Response` and :ref:`Write-Your-Own-Grader`.
A custom response problem evaluates text responses from students using an embedded Python script. These problems are also called "write-your-own-grader" problems. For more information, see :ref:`Custom Python Evaluated Input` Custom Python-evaluated input (also called "write-your-own-grader" problems evaluate students'.
.. _D:
......
.. _Getting Started Index:
################
Getting Started
################
.. toctree::
:maxdepth: 3
accounts
get_started
glossary
......@@ -4,56 +4,19 @@
contain the root `toctree` directive.
Contents
========
Building and Running an edX Course
========================================
.. toctree::
:numbered:
:maxdepth: 5
:maxdepth: 2
read_me
change_log
accounts
get_started
create_new_course
establish_grading_policy
organizing_course
create_html_component
create_video
create_discussion
create_problem_component
common_problems
advanced_problems
specialized_problems
external_graders
open_response_assessment
google_hangouts
tools
additional_tools
set_content_releasedates
view_course_content
export_import_course
accessibility
checking_student_progress
ora_students
discussions
discussion_guidance_moderators
course_data
course_enrollment
course_staffing
beta_testing
course_student
course_grades
staff_debug_info
glossary
Appendices
==========
.. toctree::
:maxdepth: 3
:glob:
appendices/*
getting_started/index
building_course/index
creating_content/index
problems_tools/index
releasing_course/index
running_course/index
students/index
\ No newline at end of file
......@@ -31,7 +31,7 @@ Chemical Equation Problem
The chemical equation problem type allows the student to enter text that represents a chemical equation into a text box. The LMS converts that text into a chemical equation below the text box. The grader evaluates the student's response by using a Python script that you create and embed in the problem.
.. image:: /Images/ChemicalEquationExample.png
.. image:: ../Images/ChemicalEquationExample.png
:alt: Image of a chemical equation response problem
====================================
......@@ -191,7 +191,7 @@ Specifically, the Gene Explorer does the following:
#. Finds the start codon
#. Translates the mRNA
.. image:: /Images/GeneExplorer.png
.. image:: ../Images/GeneExplorer.png
:alt: Image of the Gene Explorer
For more information about the Gene Explorer, see `The Gene Explorer <http://intro.bio.umb.edu/GX/>`_.
......@@ -233,7 +233,7 @@ Interactive Periodic Table
You can create an interactive periodic table of the elements to help your students learn about various elements' properties. In the table below, detailed information about each element appears as the student moves the mouse over the element.
.. image:: /Images/Periodic_Table.gif
.. image:: ../Images/Periodic_Table.png
:alt: Image of the interactive periodic table
.. _Create the Periodic Table:
......@@ -271,7 +271,7 @@ Students can use the molecule editor to learn how to create molecules. The molec
The molecule editor incorporates two tools: the JSME molecule editor created by Peter Erl and Bruno Bienfait, and JSmol, a JavaScript-based molecular viewer from Jmol. (You don't need to download either of these tools--Studio uses them automatically.) For more information about the JSME molecule editor, see `JSME Molecule Editor <http://peter-ertl.com/jsme/index.html>`_. For more information about JSmol, see `JSmol <http://sourceforge.net/projects/jsmol/>`_.
.. image:: /Images/Molecule_Editor.gif
.. image:: ../Images/Molecule_Editor.png
:alt: Image of the molecule editor
.. _Create the Molecule Editor:
......@@ -433,7 +433,7 @@ Multiple Choice and Numerical Input Problem
You can create a problem that combines a multiple choice and numerical input problems. Students not only select a response from options that you provide, but also provide more specific information, if necessary.
.. image:: /Images/MultipleChoice_NumericalInput.gif
.. image:: ../Images/MultipleChoice_NumericalInput.png
:alt: Image of a multiple choice and numerical input problem
.. note:: Currently, students can only enter numerals in the text field. Students cannot enter words or mathematical expressions.
......@@ -479,7 +479,7 @@ Polls
You can run polls in your course so that your students can share opinions on different questions.
.. image:: /Images/PollExample.png
.. image:: ../Images/PollExample.png
.. note:: Creating a poll requires you to export your course, edit some of your course's XML files in a text editor, and then re-import your course. We recommend that you create a backup copy of your course before you create the poll. We also recommend that you only edit the files that will contain polls in the text editor if you're very familiar with editing XML.
......@@ -649,7 +649,7 @@ Protex Protein Builder
The Protex protein builder asks students to create specified protein shapes by stringing together amino acids. In the example below, the goal protein shape is a simple line.
.. image:: /Images/ProteinBuilder.gif
.. image:: ../Images/ProteinBuilder.png
:alt: Image of the protein builder
.. _Create the Protein Builder:
......
......@@ -43,7 +43,7 @@ elements such as voltage sources, capacitors, resistors, and MOSFETs on
an interactive grid. They then submit a DC, AC, or transient analysis of
their circuit to the system for grading.
.. image:: /Images/CircuitSchematicExample.gif
.. image:: ../Images/CircuitSchematicExample.png
:alt: Image of a circuit schematic builder
Create a Circuit Schematic Builder Problem
......@@ -131,7 +131,7 @@ The JS Input problem that you create must use HTML, JavaScript, and cascading st
(CSS). You can use any application creation tool, such as the Google Web Toolkit (GWT), to
create your JS Input problem.
.. image:: /Images/JavaScriptInputExample.gif
.. image:: ../Images/JavaScriptInputExample.png
:alt: Image of a JavaScript Input problem
Create a Custom JavaScript Display and Grading Problem
......@@ -247,7 +247,7 @@ Custom Python-Evaluated Input ("Write-Your-Own-Grader")
In custom Python-evaluated input (also called "write-your-own-grader problems" problems), the grader uses a Python script that you create and embed in the problem to evaluates a student's response or provide hints. These problems can be any type. Numerical input and text input problems are the most popular write-your-own-grader problems.
.. image:: Images/CustomPythonExample.png
.. image:: ../Images/CustomPythonExample.png
:alt: Image of a write your own grader problem
Custom Python-evaluated input problems can include the following:
......@@ -536,7 +536,7 @@ Drag and Drop
In drag and drop problems, students respond to a question by dragging
text or objects to a specific location on an image.
.. image:: Images/DragAndDropProblem.png
.. image:: ../Images/DragAndDropProblem.png
:alt: Image of a drag and drop problem
Create a Drag and Drop Problem
......@@ -596,7 +596,7 @@ In an image mapped input problem, students click inside a defined area
in an image. You define this area by including coordinates in the body
of the problem.
.. image:: Images/image294.png
.. image:: ../Images/ImageMappedInputExample.png
:alt: Image of an image mapped input problem
Create an Image Mapped Input Problem
......@@ -634,7 +634,8 @@ Math Expression Input
In math expression input problems, students enter text that represents a mathematical expression into a field, and the LMS changes that text to a symbolic expression that appears below that field.
.. image:: Images/MathExpressionInputExample.gif
.. image:: ../Images/MathExpressionInputExample.png
:alt: Image of math expression input problem
Unlike numerical input problems, which only allow integers and a few select constants, math expression problems can include unknown variables and more complicated symbolic expressions. The grader uses a numerical sampling to determine whether the student's response matches the instructor-provided math expression, to a specified numerical tolerance. The instructor must specify the allowed variables in the expression as well as the range of values for each variable.
......@@ -748,7 +749,7 @@ gives the student feedback or a hint based on that response so that the
student is more likely to answer correctly on the next attempt. These
problems can be text input or multiple choice problems.
.. image:: Images/ProblemWithAdaptiveHintExample.gif
.. image:: ../Images/ProblemWithAdaptiveHintExample.png
:alt: Image of a problem with an adaptive hint
Create a Problem with an Adaptive Hint
......@@ -781,7 +782,7 @@ adjustments.
information about how to create mathematical expressions in Studio using
MathJax, see *A Brief Introduction to MathJax in Studio*.
.. image:: Images/ProblemWrittenInLaTeX.gif
.. image:: ../Images/ProblemWrittenInLaTeX.png
:alt: Image of a problem written in LaTeX
Create a Problem Written in LaTeX
......
......@@ -42,7 +42,7 @@ The Student View of a Problem
All problems on the edX platform have several component parts.
.. image:: Images/AnatomyOfExercise1.gif
.. image:: ../Images//AnatomyOfExercise1.png
:alt: Image of a problem from a student's point of view, with callouts for elements of the problem
#. **Problem text.** The problem text can contain any standard HTML formatting.
......@@ -72,13 +72,13 @@ All problems on the edX platform have several component parts.
#. **Attempts.** The instructor may set a specific number of attempts or
allow unlimited attempts.
.. image:: Images/AnatomyOfExercise2.gif
.. image:: ../Images//AnatomyOfExercise2.png
:alt: Image of a problem from a student's point of view, with callouts for attempts and showing the answer
#. **Feedback.** After a student clicks **Check**, all problems return a
green check mark or a red X.
.. image:: Images/AnatomyofaProblem_Feedback.gif
.. image:: ../Images//AnatomyofaProblem_Feedback.png
:alt: Image of feedback checkmark and x from a student's point of view
#. **Correct answer.** Most problems require that the instructor specify
......@@ -92,14 +92,14 @@ All problems on the edX platform have several component parts.
#. **Hide Answer button.**
.. image:: Images/AnatomyOfExercise3.gif
.. image:: ../Images//AnatomyOfExercise3.png
:alt: Image of a problem in the course accordian
#. **Grading.** The instructor may specify whether a group of problems
is graded. If a group of problems is graded, a clock icon appears for
that assignment in the course accordion.
.. image:: Images/clock_icon.gif
.. image:: ../Images//clock_icon.png
#. **Due date.** The date that the problem is due. A problem that is
past due does not have a **Check** button. It also does not accept
......@@ -160,7 +160,7 @@ the text for you automatically. The toolbar buttons are the following:
The following image shows a multiple choice problem in the Simple Editor.
.. image:: Images/MultipleChoice_SimpleEditor.png
.. image:: ../Images//MultipleChoice_SimpleEditor.png
:alt: Image of a problem in the simple editor
.. _Advanced Editor:
......@@ -175,7 +175,7 @@ For more information about the XML for different problem types, see :ref:`Append
The following image shows the multiple choice problem above in the Advanced Editor
instead of the Simple Editor.
.. image:: Images/MultipleChoice_AdvancedEditor.png
.. image:: ../Images//MultipleChoice_AdvancedEditor.png
:alt: Image of a problem in the advanced editor
.. _Problem Settings:
......@@ -193,7 +193,7 @@ the component editor.
- **Randomization**
- **Show Answer**
.. image:: Images/ProbComponent_Attributes.png
.. image:: ../Images//ProbComponent_Attributes.png
:alt: Image of the Settings tab in a Problem component
===============
......@@ -204,7 +204,7 @@ This setting indicates the name of your problem. The display name
appears as a heading over the problem in the LMS and in the course
ribbon at the top of the page.
.. image:: Images/ProbComponent_LMS_DisplayName.gif
.. image:: ../Images//ProbComponent_LMS_DisplayName.png
:alt: Image of the problem in a unit page from a student's point of view
==============================
......@@ -227,7 +227,7 @@ Problem Weight
This setting specifies the maximum number of points possible for the
problem. The problem weight appears next to the problem title.
.. image:: Images/ProblemWeight_DD.gif
.. image:: ../Images//ProblemWeight_DD.png
:alt: Image of a problem from a student's point of view, with the possible points circled
By default, each response field, or “answer space,” in a Problem
......@@ -239,7 +239,7 @@ to answer, and thus has three response fields.
The following Problem component contains one text input problem,
and has just one response field.
.. image:: Images/ProblemWeight_TI.gif
.. image:: ../Images//ProblemWeight_TI.png
:alt: Image of a text input problem from a student's point of view
Computing Scores
......@@ -294,7 +294,7 @@ This setting specifies whether certain values in your problem change each time a
.. image:: Images/Rerandomize.gif
.. image:: ../Images//Rerandomize.png
If you want to change, or "randomize," specific values in your problem, you have to do both the following:
......@@ -385,7 +385,7 @@ page for the problem type.
in the Advanced component.
- :ref:`Open Response Assessment Problems` are a new kind of problem that allow you, the
students in your course, or a computer algorithm to grade responses in the form
of essays, files such as computer code, and images.
of essays, files such as computer code, and ../Images/.
.. _Multiple Problems in One Component:
......
......@@ -454,7 +454,7 @@ Template
</problem>
Tags
====
----
* ``<imageresponse>``: Indicates that the problem is an image mapped input problem.
* ``<imageinput>``: Specifies the image file and the region in the file that the student must click.
......@@ -737,7 +737,7 @@ Problem with a decimal tolerance
</problem>
Problem with a percentage tolerance
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. code-block:: xml
......@@ -1163,4 +1163,3 @@ Surround the text of the hint.
......@@ -31,13 +31,13 @@ An external grader is particularly useful for software programming courses where
For example, you define a problem that requires students to submit Python code, and create a set of tests that an external grader can run to verify the submissions. When a student enters Python code for the problem and clicks **Check**, the code is sent to the grader for testing. If the code passes all tests, the grader returns the score and a string indicating that the solution is correct.
.. image:: Images/external-grader-correct.png
.. image:: ../Images/external-grader-correct.png
:alt: Image of a students view of a programming problem that uses an external grader, with a correct result
The external grader can return a string with results, which the student can see by clicking **See full output**. This can be particularly useful when the solution is not correct and you want to return information about the failed tests. For example:
.. image:: Images/external-grader-incorrect.png
.. image:: ../Images/external-grader-incorrect.png
:alt: Image of a students view of a programming problem that uses an external grader, with a correct result
.. _External Graders and XQueue:
......
.. _Appendix F:
Appendix F - Files for the Example Custom JavaScript Display and Grading Problem
Files for the Example Custom JavaScript Display and Grading Problem
================================================================================
For the example :ref:`Custom JavaScript Display and Grading` problem, you need the following files. You can find
......
......@@ -42,7 +42,7 @@ HTML (Text) Components
In the HTML component editor, you can use MathJax both in Visual view and in HTML view.
.. image:: ../Images/MathJax_HTML.gif
.. image:: ../Images/MathJax_HTML.png
:alt: Image of an HTML component with MathJax in both the Visual and HTML views
Problem Components
......@@ -56,5 +56,5 @@ explanation is enclosed in backslashes and parentheses, so it appears inline wit
Navier-Stokes equation is enclosed in backslashes and brackets, so it appears on its
own line.
.. image:: ../Images/MathJax_Problem.gif
.. image:: ../Images/MathJax_Problem.png
:alt: Image of a problem component with MathJax in both the Visual and HTML views
\ No newline at end of file
......@@ -52,28 +52,28 @@ The Student Experience
When you add the instant hangout to your course, a control for the hangout appears on that page. The following example shows the control in a course unit. The control shows that the student can start the hangout and be the first participant.
.. image:: Images/hangout_unit.png
.. image:: ../Images/hangout_unit.png
:alt: Image of the instant hangout control on a unit
To start the hangout, the student clicks **Start the Hangout**. (After the first student clicks **Start the Hangout**, other students see a **Join the Hangout** button.)
The following example shows the control in a static page when a hangout has already started. The control has a **Join the Hangout** button, and shows that one other student is already in the hangout.
.. image:: Images/hangout_static_page.png
.. image:: ../Images/hangout_static_page.png
:alt: Image of the instant hangout control on a static page
To join the hangout, the student clicks **Join the Hangout**.
If not already logged in, the student is prompted to log in to Google:
.. image:: Images/google_login.png
.. image:: ../Images/google_login.png
:alt: Image of the Google login page
Students who do not have a Google account can create one from the login page.
After the student has logged in to Google, the hangout opens in a separate browser window:
.. image:: Images/hangout.png
.. image:: ../Images/hangout.png
:alt: Image of the instant hangout
.. _Limitations:
......
.. _Working with Problems Index:
##########################
Working with Problems
##########################
.. toctree::
:maxdepth: 2
create_problem_component
common_problems
advanced_problems
specialized_problems
e
external_graders
open_response_assessment
tools
additional_tools
google_hangouts
f
g
......@@ -18,7 +18,7 @@ Specialized problems are advanced problems such as annotations. These problems a
By default, when you create a new component in Studio, you see the
following options.
.. image:: Images/AddNewComponent.gif
.. image:: ../Images/AddNewComponent.png
:alt: Image of the Add a New Component panel
To create a specialized problem, you must first add the Advanced
......@@ -30,10 +30,10 @@ component to your course. To do this, follow these steps.
Definition** section, and then locate the **advanced_modules**
policy key (this key is at the top of the list).
.. image:: Images/AdvancedModulesEmpty.gif
.. image:: ../Images/AdvancedModulesEmpty.png
:alt: Image of the Manual Policy Definition section of the Advanced Settings page
#. Under **Policy Value**, place your cursor between the brackets, and
3. Under **Policy Value**, place your cursor between the brackets, and
then enter the value for the type of problem that you want to create.
Make sure to include the quotation marks, but not the period.
......@@ -53,23 +53,23 @@ component to your course. To do this, follow these steps.
"annotatable","word_cloud"
.. image:: Images/AdvSettings_Before.png
.. image:: ../Images/AdvSettings_Before.png
:alt: Image of the Manual Policy Definition section of the Advanced Settings page, with specialized problems added
#. At the bottom of the page, click **Save Changes**.
4. At the bottom of the page, click **Save Changes**.
The page refreshes automatically. At the top of the page, you see a
notification that your changes have been saved.
The text in the **Policy Value** field now appears as follows.
.. image:: Images/AdvSettings_After.png
.. image:: ../Images/AdvSettings_After.png
:alt: Image of the Manual Policy Definition section of the Advanced Settings page, with specialized problems added after saving
#. Return to the unit where you want to add the specialized problem. The
5. Return to the unit where you want to add the specialized problem. The
list of possible components now contains an Advanced component.
.. image:: Images/AdvancedComponent.gif
.. image:: ../Images/AdvancedComponent.png
:alt: Image of the Add a New Component panel with the Advanced component option
When you click the Advanced component, you can see **Annotation** and **Word cloud** in the list. More information about how to create each problem is provided in the page for that problem type.
......@@ -86,7 +86,7 @@ questions appear when students hover the mouse over the highlighted
text. The questions also appear in a section below the text block, along
with space for students' responses.
.. image:: Images/AnnotationExample.gif
.. image:: ../Images/AnnotationExample.png
:alt: Image of an annotation problem
Create an Annotation Problem
......@@ -120,7 +120,7 @@ Add the **Annotation problem** segment of the problem.
placeholders with your own information.
::
::
<problem>
<annotationresponse>
......
......@@ -29,17 +29,17 @@ The Student View of a Full Screen Image
-----------------------------------------
The student sees the full screen image in a unit page. When the student hovers the mouse pointer over the image, the **Fullscreen** button appears:
.. image:: Images/image-modal.png
.. image:: ../Images/image-modal.png
:alt: Image of the full screen image tool with the Full Screen button.
When the student clicks **Fullscreen**, the image opens and expands in the full browser window. The buttons **Close**, **Zoom In**, and **Zoom Out** appear:
.. image:: Images/image-modal-window.png
.. image:: ../Images/image-modal-window.png
:alt: Image of the Image Modal tool with the Full Screen button.
The student can then zoom in on the image, and drag the image to view the desired part of it:
.. image:: Images/image-modeal-zoomed.png
.. image:: ../Images/image-modeal-zoomed.png
:alt: Image of the Image Modal tool with the Full Screen button.
......@@ -145,14 +145,14 @@ Step 1. Add LTI to the Advanced Modules Policy Key
Definition** section, and then locate the **advanced_modules**
policy key (this key is at the top of the list).
.. image:: Images/AdvancedModulesEmpty.gif
.. image:: ../Images/AdvancedModulesEmpty.png
:alt: Image of the advanced_modules key in the Advanced Settings page
#. Under **Policy Value**, place your cursor between the brackets, and
then enter **“lti”**. Make sure to include the quotation marks, but
not the period.
.. image:: Images/LTIPolicyKey.gif
.. image:: ../Images/LTIPolicyKey.png
:alt: Image of the advanced_modules key in the Advanced Settings page, with the LTI value added
**Note** If the **Policy Value** field already contains text, place your
......@@ -285,7 +285,7 @@ their thoughts to the group.
For example, the following word cloud was created from students'
responses to a question in a HarvardX course.
.. image:: Images/WordCloudExample.gif
.. image:: ../Images/WordCloudExample.png
:alt: Image of a word cloud problem
Create a Word Cloud Exercise
......@@ -332,7 +332,7 @@ Zooming Image Tool
You may want to present information to your students as an image. If your image is very large or very detailed, students may not be able to see all the information in the image. You can use the zooming image tool to enlarge areas of your image as the student moves the mouse over the image, as in the example below.
.. image:: Images/Zooming_Image.gif
.. image:: ../Images/Zooming_Image.png
:alt: Example zooming image tool showing a chemistry exercise
Components of a Zooming Image Tool
......@@ -381,7 +381,7 @@ Create a Zooming Image Tool
The HTML in your zooming image tool may resemble the following.
.. image:: Images/ZoomingImage_Modified.gif
.. image:: ../Images/ZoomingImage_Modified.png
:alt: Example HTML for a zooming image tool
#. Click **Save** to save the HTML component.
......
......@@ -129,7 +129,7 @@ To define the start of the beta test, you use Studio to specify a number of days
#. Scroll down to the ``days_early_for_beta`` **Policy Key**.
#. Set the **Policy Value** to a number of days before section and subsection **Release Day**s.
#. Set the **Policy Value** to a number of days before the **Release Day** for the section and subsection.
#. Click **Save Changes**.
......
.. raw:: latex
\newpage %
======================
APPENDIX D: Time Zones
Time Zones
======================
**Overview**
......
.. _Releasing Your Course Index:
##########################
Releasing Your Course
##########################
.. toctree::
:maxdepth: 2
beta_testing
view_course_content
set_content_releasedates
staff_debug_info
d
......@@ -149,7 +149,7 @@ To make revisions to a unit that has been published, you create and edit a draft
To create a draft, go to the unit's page, and then click **edit a draft** in the right pane.
.. image:: Images/Viz_Revise_EditDraft.png
.. image:: ../Images/Viz_Revise_EditDraft.png
:width: 800
:alt: Image of a public unit with the edit a draft link circled
......@@ -158,7 +158,7 @@ When you edit a draft of a unit, you can view the unit's contents in two ways.
* To view the already-published content as it appears in the live course, click **View the Live Version** in the upper-right corner of the page.
* To view the unpublished content as you're working on it, click **Preview**.
.. image:: Images/Viz_Revise_ViewLiveandPreview.png
.. image:: ../Images/Viz_Revise_ViewLiveandPreview.png
:alt: Image of draft unit
When you're ready to publish the draft of your revised content,
......@@ -166,7 +166,7 @@ click **replace it with this draft** in the right pane.
If you decide you don't want to keep the revised content, click **Delete Draft**.
.. image:: Images/Viz_Revise_ReplaceorDelete.png
.. image:: ../Images/Viz_Revise_ReplaceorDelete.png
:alt: Image of a unit settings panel with the replace it with this draft link circled
.. Warning:: Historical versions of units are not stored by Studio. After you replace the live version with a new draft, you cannot revert the unit to the previous version.
......
......@@ -34,7 +34,7 @@ You can enter Preview mode in two ways.
* On any subsection page, click **Preview Drafts**.
.. image:: Images/preview_draft.png
.. image:: ../Images/preview_draft.png
:width: 800
:alt: Image of a subsection with the Preview Drafts button circled
......@@ -43,7 +43,7 @@ You can enter Preview mode in two ways.
The following example shows the **Preview** button for a unit that
is set to Public.
.. image:: Images/preview_public.png
.. image:: ../Images/preview_public.png
:width: 800
:alt: Image of a public unit with the Preview button circled
......@@ -51,7 +51,7 @@ You can enter Preview mode in two ways.
The following example shows the **Preview** button for a unit that
is set to Private.
.. image:: Images/preview_private.png
.. image:: ../Images/preview_private.png
:width: 800
:alt: Image of a private unit with the Preview button circled
......@@ -72,19 +72,19 @@ You can view the live course from three different places in Studio:
* The **Course Outline** page.
.. image:: Images/course_outline_view_live.png
.. image:: ../Images/course_outline_view_live.png
:width: 800
:alt: Image of the course outline with the View Live button circled
* Any Subsection page.
.. image:: Images/subsection_view_live.png
.. image:: ../Images/subsection_view_live.png
:width: 800
:alt: Image of a subsection with the View Live button circled
* The Unit page, if the Unit is Public.
.. image:: Images/unit_view_live.png
.. image:: ../Images/unit_view_live.png
:width: 800
:alt: Image of a unit with the View Live button circled
......@@ -26,7 +26,7 @@ percent needed for each grade cutoff. Here is an example of a student's
progress through edX101.
.. image:: Images/image245.png
.. image:: ../Images/image245.png
:width: 800
:alt: Image of a student's Course Progress page with the grade cutoffs legend highlighted
......@@ -45,7 +45,7 @@ recorded for the student for all problems in the course. Here is a scrolled
down view of the example Progress page for the student in the example above:
.. image:: Images/image247.png
.. image:: ../Images/image247.png
:width: 800
:alt: Image of a student's Course Progress page with problems highlighted
......@@ -66,7 +66,7 @@ more course-specific tools get added. Here is the current view of the top of
the Grades page of the Instructor dashboard for edX101:
.. image:: Images/image249.png
.. image:: ../Images/image249.png
:width: 800
:alt: Image of the Grades tab of the Instructor Dashboard
......
......@@ -28,7 +28,7 @@ Before a student can be enrolled in a course, he or she must:
#. Activate the registered account by following the emailed instructions.
Students can then enroll themselves in edx.org courses, or can enroll in other courses if they know the URL. For a more detailed description of this process from a student's point of view, see :doc:`appendices/c`.
Students can then enroll themselves in edx.org courses, or can enroll in other courses if they know the URL. For a more detailed description of this process from a student's point of view, see :ref:`Sample Student Login Guide`.
Course authors and instructors can enroll students in a course either before or after the students register their user accounts.
......@@ -50,7 +50,7 @@ When you enroll students, you have options to:
An example of the email message that students receive when you select this option follows.
.. image:: Images/Course_Enrollment_Email.png
.. image:: ../Images/Course_Enrollment_Email.png
:alt: Email message inviting a student to enroll in the EdX 101 course
To enroll students or staff members:
......
......@@ -36,12 +36,12 @@ You establish a grading policy for your course when you create it in Studio. Whi
A list of the assignment types in your course displays. In this example, Homework is weighted as 60% of the grade.
.. image:: Images/Grading_Configuration.png
.. image:: ../Images/Grading_Configuration.png
:alt: XML of course assignment types and weights for grading
In Studio, you define this information by selecting **Settings** > **Grading**.
.. image:: Images/Grading_Configuration_Studio.png
.. image:: ../Images/Grading_Configuration_Studio.png
:alt: Studio example of homework assignment type and grading weight
For more information, see :ref:`Configure the Assignment Types`.
......@@ -115,7 +115,7 @@ To view current grades for a student:
The Course Progress page for the student displays a chart with the grade for each homework, lab, midterm, final, and any other assignment types in your course, and the total grade earned for the course to date.
.. image:: Images/Student_Progress.png
.. image:: ../Images/Student_Progress.png
:alt: A bar chart from a student's Progress page showing grade acheived for each assignment
=========================================================
......@@ -195,7 +195,7 @@ To find the unique identifier in the URL for a problem:
Information about the problem displays, including its location or URL. This URL ends with the type of module, which is typically "problem", and the unique identifier.
.. image:: Images/Problem_URL.png
.. image:: ../Images/Problem_URL.png
:alt: The Staff Debug view of a problem with the unique identifier indicated at the end of a URL address
......
......@@ -42,7 +42,7 @@ Student-reported data
When students register with edX, they select a public username and supply information about themselves. Most of this information is optional, so not all of the students who are enrolled in your course provide it.
.. image:: Images/Registration_page.png
.. image:: ../Images/Registration_page.png
:alt: Fields that collect student information during registration
Students then register for as many individual courses as they choose, which enrolls them in each selected course.
......@@ -82,7 +82,7 @@ To view or download student data:
A table of the student data displays, with one row for each enrolled student. Longer values, such as student goals, are truncated.
.. image:: Images/StudentData_Table.png
.. image:: ../Images/StudentData_Table.png
:alt: Table with columns for the collected data points and rows for each student on the Instructor Dashboard
.. note:: In the future, edX may also request that students select a language and location. This data is not collected at this time.
......@@ -111,10 +111,10 @@ To display demographic data for your students:
* The Gender Distribution and Level of Education sections show tables with counts of responses made by enrolled students.
.. image:: Images/Distribution_Education.png
.. image:: ../Images/Distribution_Education.png
:alt: Table with columns for different possible values for gender and total count reported for each value
.. image:: Images/Distribution_Gender.png
.. image:: ../Images/Distribution_Gender.png
:alt: Table with columns for different possible values for level of education completed and total count reported for each value
"No Data" is the sum of the students for whom no value exists for the demographic.
......
......@@ -89,7 +89,7 @@ To create a discussion category:
When students click the **Discussion** static page for your course, the drop-down list includes this new category.
.. image:: Images/NewCategory_Discussion.png
.. image:: ../Images/NewCategory_Discussion.png
:alt: Image of a new discussion category
.. _Assigning_discussion_roles:
......@@ -177,13 +177,13 @@ To encourage longer, threaded discussions rather than many similar, separate pos
* Pin a post.
Pinning a post makes it appear first in the discussion, so that it is more likely that students will see and respond to it. Otherwise, each post is listed in reverse chronological order or sorted as each student chooses. You can write your own post and then pin it, or pin a post by any author. Click **Pin Thread**.
.. image:: Images/Pin_Discussion.png
.. image:: ../Images/Pin_Discussion.png
:alt: Image of the pin icon for discussion posts
* Endorse a response.
Endorsing a response indicates that it provides value to the discussion, such as a correct answer to a question. Click the **check mark** that displays at upper right of the response.
.. image:: Images/Endorse_Discussion.png
.. image:: ../Images/Endorse_Discussion.png
:alt: Image of the Endorse button for discussion posts
* Close a thread.
......
.. _Running Your Course Index:
##########################
Running Your Course
##########################
.. toctree::
:maxdepth: 2
checking_student_progress
discussions
discussion_guidance_moderators
course_data
course_enrollment
course_staffing
course_student
course_grades
\ No newline at end of file
.. _Information for Your Students Index:
##############################
Information for Your Students
##############################
.. toctree::
:maxdepth: 2
ora_students
login_guide
.. _Sample Student Login Guide:
======================================
APPENDIX C: Sample Student Login Guide
Sample Student Login Guide
======================================
Create a login guide for your individual course.
......@@ -46,7 +46,7 @@ Click on the blue Register for [NUMBER OF YOUR CLASS] button:
A pop-up user authentication window will appear. It will ask you to log in or sign up for edX. (If you already have an account with edX, use it to log in. You should now be registered for the course. Skip to Step 5. Otherwise, go on with Step 3.)
.. image:: ../Images/image305.png
.. image:: ../Images/Image305.png
:width: 600
:alt: Image of the registration page
......
......@@ -24,12 +24,12 @@ When you come to an open response assessment problem, you see the name of the
problem, the assessment types, the text of the question, the field where you'll
enter your response, and the **Save** and **Submit** buttons.
.. image:: /Images/ExampleORA.gif
.. image:: ../Images/ExampleORA.png
If an open response assessment asks you to submit a file, you'll also see a button
that you'll click to upload your file.
.. image:: /Images/ExampleORA_File.gif
.. image:: ../Images/ExampleORA_File.png
The *assessment types* can include *self assessment*, *peer assessment*, and *artificial intelligence (AI) assessment*. The
assessment types run in the order in which they appear in the problem.
......@@ -117,7 +117,7 @@ Perform a Self Assessment
#. When the rubric appears, compare your response with the rubric, and select the
option that you think is appropriate for each category.
.. image:: /Images/Rubric1.gif
.. image:: ../Images/Rubric1.png
#. Click **Submit assessment**.
......@@ -155,7 +155,7 @@ one peer grading interface. There may be just one peer grading interface
for the whole course, or each individual problem may have its own
separate peer grading interface.
.. image:: /Images/PGI_FromOEC_2Problems.gif
.. image:: ../Images/PGI_FromOEC_2Problems.png
Perform a Peer Assessment
......@@ -191,7 +191,7 @@ there are more essays from other students left to grade. If you haven't submitte
a response or no responses are available for grading, you see a yellow message in the
interface.*
.. image:: /Images/PAStudent_NoSubmissions.gif
.. image:: ../Images/PAStudent_NoSubmissions.png
There are several ways to access other students' responses, depending on
......@@ -203,7 +203,7 @@ the way that the course is set up.
When you see the list of problems that have responses available to grade,
click the name of the problem that you want to open it.
.. image:: /Images/PGI_FromOEC_2Problems.gif
.. image:: ../Images/PGI_FromOEC_2Problems.png
- Through the courseware, in a specific unit. This option is only available if the
instructor has included a peer grading interface for the problem in the body of
......@@ -211,7 +211,7 @@ the way that the course is set up.
the open response assessment problem. Scroll down past the response that you
submitted until you see the peer grading interface that appears below the problem.
.. image:: /Images/PGI_InUnitComposite.gif
.. image:: ../Images/PGI_InUnitComposite.png
- Through the courseware, in a separate section. This option may not be available
for your course. If it is, you'll see the section for peer grading in the
......@@ -220,7 +220,7 @@ the way that the course is set up.
that holds all the course peer grading interfaces. To access peer grading for
a problem, you click the problem name.
.. image:: /Images/PGI_Multiple-600x.gif
.. image:: ../Images/PGI_Multiple-600x.png
.. _Learn to Grade:
......@@ -244,9 +244,9 @@ other students' responses to the question.
#. Review the **How did I do?** message that you receive, and then click
**Continue**.
.. image:: /Images/PG_Calibration_Correct.gif
.. image:: ../Images/PG_Calibration_Correct.png
.. image:: /Images/PG_Calibration_Incorrect.gif
.. image:: ../Images/PG_Calibration_Incorrect.png
When you click **Continue**, the next student response appears for
you to grade, and you see a yellow **Calibration essay saved** message in
......@@ -288,7 +288,7 @@ student who submitted the response.
responses (usually 3). When you've graded enough responses, you
receive the following message.
.. image:: /Images/DoneGrading.gif
.. image:: ../Images/DoneGrading.png
When you see this message, you can access the score for your own
response. For more information, see :ref:`ORA Access Scores`.
......@@ -373,13 +373,13 @@ For *peer assessments* and *AI assessments*, you'll access your scores through t
For both AI and peer assessments, the score appears below your response
in an abbreviated version of the rubric.
.. image:: /Images/AIScoredResponse.gif
.. image:: ../Images/AIScoredResponse.png
For peer assessments, you can
also see the written feedback that your response received from different
graders.
.. image:: /Images/PeerScoredResponse.gif
.. image:: ../Images/PeerScoredResponse.png
If you want to see the full rubric for either an AI or peer assessment,
click **Toggle Full Rubric**.
......@@ -388,7 +388,7 @@ click **Toggle Full Rubric**.
problems to see your score, you receive a message that lets you know how
many problems you still need to grade.
.. image:: /Images/FeedbackNotAvailable.gif
.. image:: ../Images/FeedbackNotAvailable.png
For more information about grading peer assessments, see :ref:`ORA Peer Assessment`.
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment