diff --git a/source/educators/concepts/advanced_features/cohorts_overview.rst b/source/educators/concepts/advanced_features/cohorts_overview.rst index d89434db8..8fc8126e4 100644 --- a/source/educators/concepts/advanced_features/cohorts_overview.rst +++ b/source/educators/concepts/advanced_features/cohorts_overview.rst @@ -13,7 +13,7 @@ This section provides an introduction to using cohorts to divide the learners in For more information about setting up and managing cohorts, see the following topics. -* :ref:`Enabling and Configuring Cohorts` +* :ref:`Enable Cohorts` * :ref:`Setting Up Discussions in Courses with Cohorts` @@ -27,7 +27,7 @@ For information about offering different content to different cohorts of learner Overview ********* -To create smaller communities in your course, or to design different course experiences for different groups of learners, you can :ref:`set up cohorts` in your course. +To create smaller communities in your course, or to design different course experiences for different groups of learners, you can :ref:`set up cohorts` in your course. To use cohorts in your course, you define a set of cohorts that are either random or that reflect some characteristic of the communities of learners in your course. Then, you decide on a strategy for :ref:`assigning learners to these cohorts`. diff --git a/source/educators/concepts/advanced_features/timed_exams.rst b/source/educators/concepts/advanced_features/timed_exams.rst index 8828c1b93..4c7a6002d 100644 --- a/source/educators/concepts/advanced_features/timed_exams.rst +++ b/source/educators/concepts/advanced_features/timed_exams.rst @@ -1,21 +1,10 @@ .. _Timed Exams: -###################### Timed Exams -###################### +############# .. tags:: educator, concept -This topic describes how to add and manage timed exams in your course. - -.. contents:: - :local: - :depth: 2 - -********** -Overview -********** - You can configure a :ref:`subsection ` in your course so that learners have a set amount of time to complete and submit all problems in that subsection. @@ -33,15 +22,10 @@ Course teams can grant individual learners more time to complete problems in the subsection, but only if learners request additional time **before** starting a timed exam. -.. note:: - Learners cannot complete timed exams using the edX mobile app. +.. seealso:: + :class:dropdown + + :ref:`Configure Timed Exams` -To better understand the learner's experience of timed exams, see -`taking_timed_exams`_ in the *edX Learner's Guide* or -`taking_timed_exams`_ in the *Open edX Learner's Guide*. -.. only:: Partners - Timed exams are different from :ref:`proctored exams`. - While both types of exams have a time limit, learners are monitored only - during proctored exams. diff --git a/source/educators/concepts/exercise_tools/peer_instruction.rst b/source/educators/concepts/exercise_tools/peer_instruction.rst index 519c5d21c..02c7c2529 100644 --- a/source/educators/concepts/exercise_tools/peer_instruction.rst +++ b/source/educators/concepts/exercise_tools/peer_instruction.rst @@ -87,10 +87,6 @@ course. discussion component after the peer instruction component to give learners an opportunity to continue the conversation. - For more information about how learners experience peer instruction - assignments, see 'interactive_multiple_choice' in the - *Open edX Learner's Guide*. - .. _Enable the Peer Instruction Tool: ================================== @@ -105,10 +101,10 @@ the **Advanced Module List** on the **Advanced Settings** page. Be sure to include quotation marks around the key value. For more information, see :ref:`Enable Additional Exercises and Tools`. -.. note:: This tool was developed and contributed to the edX platform by the +.. note:: This tool was developed and contributed to the Open edX platform by the University of British Columbia. .. seealso:: :class: dropdown - :ref:`Add Peer Instruction Assignment` (how to) \ No newline at end of file + :ref:`Add Peer Instruction Assignment` (how to) diff --git a/source/educators/concepts/exercise_tools/randomized_content.rst b/source/educators/concepts/exercise_tools/randomized_content.rst index df2c3fdc2..a3f5c70c0 100644 --- a/source/educators/concepts/exercise_tools/randomized_content.rst +++ b/source/educators/concepts/exercise_tools/randomized_content.rst @@ -6,7 +6,7 @@ Randomized Content Blocks .. tags:: educator, concept -If your course has :ref:`content libraries` enabled and you +If your course has :ref:`content libraries` enabled and you have access to a library whose content you want to use, you can reference that library to create randomized assignments for students. @@ -17,7 +17,7 @@ of problem to randomly give each student. The libraries that you create or have access to are listed on the **Libraries** tab on the Studio Home page. For details about content libraries, see -:ref:`Content Libraries`. +:ref:`Content Libraries Overview`. .. seealso:: :class: dropdown diff --git a/source/educators/concepts/exercise_tools/single_select_overview.rst b/source/educators/concepts/exercise_tools/single_select_overview.rst index b72bd52b2..70bc1ad62 100644 --- a/source/educators/concepts/exercise_tools/single_select_overview.rst +++ b/source/educators/concepts/exercise_tools/single_select_overview.rst @@ -1,8 +1,7 @@ .. _Single Select Overview: -******** Overview -******** +######### .. tags:: educator, concept @@ -16,9 +15,8 @@ reordering, or shuffling, the set of answer choices for each learner. For more information about these options, see :ref:`Editing Single Select Problems using the Advanced Editor`. -============================= Example Single Select Problem -============================= +******************************* In the LMS, learners select a single answer option to complete a single select problem. An example of a completed single select problem follows. @@ -29,11 +27,11 @@ select problem. An example of a completed single select problem follows. the answer options. :width: 600 -====================================================== + Pedagogical Considerations for Single Select Questions -====================================================== +******************************************************* -EdX recommends the use, whenever possible, of authentic assessment rather than +It is recommended the use, whenever possible, of authentic assessment rather than single select questions for graded problems. The use of authentic assessment in online courses tends to lead to better learning outcomes. In addition, authentic assessment allows for infinite attempts, mastery learning, and more diff --git a/source/educators/concepts/exercise_tools/staff_graded.rst b/source/educators/concepts/exercise_tools/staff_graded.rst index d0c5fe741..8b786afbf 100644 --- a/source/educators/concepts/exercise_tools/staff_graded.rst +++ b/source/educators/concepts/exercise_tools/staff_graded.rst @@ -1,8 +1,7 @@ .. _StaffGraded Grading: -================ Grading Learners -================ +################# .. tags:: educator, concept diff --git a/source/educators/how-tos/course_development/Subsection_configure_hints.rst b/source/educators/how-tos/course_development/Subsection_configure_hints.rst index f3f409c70..7c547af39 100644 --- a/source/educators/how-tos/course_development/Subsection_configure_hints.rst +++ b/source/educators/how-tos/course_development/Subsection_configure_hints.rst @@ -1,20 +1,31 @@ .. _Configure Hint: -***************** -Configure Hint -***************** +Configure a Hint in a Problem +############################## .. tags:: educator, how-to -In the settings panels on the right of the editor, you'll find a Hints panel. +#. You will find the Hints panel at the settings panels on the right side of the problem editor. + +#. There, click the **Add hint** button to add a new hint text field. .. image:: /_images/educator_how_tos/problem_editor_hints_box.png :alt: An example of the hints settings panel. :width: 200 -Click the **Add hint** button to add a new hint text field. To delete any hints -you've added, click the trash can icon next to its respective hint field. +#. To delete any hints you've added, click the trash can icon next to its respective hint field. .. note:: You can configure any number of hints. The learner views one hint at a time - and views the next one by selecting **Hint** again. \ No newline at end of file + and views the next one by selecting **Hint** again. + +.. seealso:: + :class:dropdown + + :ref:`Adding Feedback and Hints to a Problem` (reference) + + :ref:`Adding Hints via the Advanced Editor` (how-to) + + :ref:`Use Hints in a Dropdown Problem` (how-to) + + :ref:`Problem Settings` (reference) diff --git a/source/educators/how-tos/course_development/exercise_tools/add_hints_advanced_editor.rst b/source/educators/how-tos/course_development/exercise_tools/add_hints_advanced_editor.rst index 3808df6ee..bdc4ad00d 100644 --- a/source/educators/how-tos/course_development/exercise_tools/add_hints_advanced_editor.rst +++ b/source/educators/how-tos/course_development/exercise_tools/add_hints_advanced_editor.rst @@ -1,8 +1,8 @@ .. _Adding Hints via the Advanced Editor: -======================================== + Adding Hints via the Advanced Editor -======================================== +##################################### .. tags:: educator, how-to @@ -10,6 +10,8 @@ In the advanced editor, you add the ```` element immediately before the closing ```` tag, and then configure each hint using the ```` element. +For example: + .. code-block:: xml diff --git a/source/educators/how-tos/course_development/exercise_tools/add_peer_instruction_tool.rst b/source/educators/how-tos/course_development/exercise_tools/add_peer_instruction_tool.rst index d956764cc..64d06d4e4 100644 --- a/source/educators/how-tos/course_development/exercise_tools/add_peer_instruction_tool.rst +++ b/source/educators/how-tos/course_development/exercise_tools/add_peer_instruction_tool.rst @@ -1,8 +1,7 @@ .. _Add Peer Instruction Assignment: -************************************************ Adding a Peer Instruction Assignment in Studio -************************************************ +############################################### .. tags:: educator, how-to @@ -10,20 +9,9 @@ Adding a Peer Instruction Assignment in Studio :local: :depth: 1 -.. _Upload PI Images: - -================================= -Upload Images (Optional) -================================= - -If the question or an answer choice in an assignment includes an image, you -:ref:`upload the image file` on the **Files & Uploads** page. -The **Studio URL** for the image can then be added to the question or -answer choice in the peer instruction component. -============================================ Add a Peer Instruction Component -============================================ +*********************************** After you :ref:`enable the peer instruction tool ` for your course, you can add the component for a peer instruction @@ -52,9 +40,9 @@ assignment. #. Select **Save**, or continue on to replace the template information with the details for this assignment. -============================================ + Add the Assignment Details -============================================ +************************** Before you add the details of the assignment to a peer instruction component, you :ref:`design the assignment` by @@ -167,6 +155,16 @@ reviewed the responses submitted by other class participants. frequency. :width: 600 +.. _Upload PI Images: + +Upload Images (Optional) +************************** + +If the question or an answer choice in an assignment includes an image, you +:ref:`upload the image file` on the **Files & Uploads** page. +The **Studio URL** for the image can then be added to the question or +answer choice in the peer instruction component. + .. seealso:: :class: dropdown diff --git a/source/educators/how-tos/course_development/exercise_tools/create_periodic_table.rst b/source/educators/how-tos/course_development/exercise_tools/create_periodic_table.rst index 968876c17..a0515f22e 100644 --- a/source/educators/how-tos/course_development/exercise_tools/create_periodic_table.rst +++ b/source/educators/how-tos/course_development/exercise_tools/create_periodic_table.rst @@ -16,9 +16,8 @@ element. .. _Create the Periodic Table: -****************************** Create the Periodic Table Tool -****************************** +############################### To create a periodic table, you need the following files: @@ -42,4 +41,9 @@ To create the periodic table, you need a Text component. #. Copy all of the text in the PeriodicTable.txt file, and paste it into the Text component editor. (Note that the PeriodicTableHTML.txt file contains over 6000 lines of code. Paste all of this code into the component editor.) -#. Click **Save**. \ No newline at end of file +#. Click **Save**. + +.. seealso:: + :class:dropdown + + :ref:`Working with Problem Components`