FC-0068 docs: concept and how-tos cleaning by edunext 13 (#756)

* FC-0068 docs: concept and how-tos cleaning by edunext 13

This PR modifies a series of how-tos and concepts documents migrated from the legacy repositories to the educators' documentation.

* Update Subsection_configure_hints.rst

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<Set up Discussions in Cohorted Courses>`
 
@@ -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<Enabling and Configuring 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<Enable 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<Options for Assigning Learners to Cohorts>`.
 

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 <Developing Course Subsections>`
 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<CA_ProctoredExams>`.
-  While both types of exams have a time limit, learners are monitored only
-  during proctored exams.

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)
+ :ref:`Add Peer Instruction Assignment` (how to)

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<Content Libraries>` enabled and you
+If your course has :ref:`content libraries<Content Libraries Overview>` 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

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

source/educators/concepts/exercise_tools/staff_graded.rst

@@ -1,8 +1,7 @@
 .. _StaffGraded Grading:
 
-================
 Grading Learners
-================
+#################
 
 .. tags:: educator, concept
 

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.
+  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)

source/educators/how-tos/course_development/exercise_tools/add_hints_advanced_editor.rst

@@ -1,15 +1,17 @@
 .. _Adding Hints via the Advanced Editor:
 
-========================================
+
 Adding Hints via the Advanced Editor
-========================================
+#####################################
 
 .. tags:: educator, how-to
 
 In the advanced editor, you add the ``<demandhint>`` element immediately before
 the closing ``</problem>`` tag, and then configure each hint using the
 ``<hint>`` element.
 
+For example:
+
 .. code-block:: xml
 
   <problem>

source/educators/how-tos/course_development/exercise_tools/add_peer_instruction_tool.rst

@@ -1,29 +1,17 @@
 .. _Add Peer Instruction Assignment: 
 
-************************************************
 Adding a Peer Instruction Assignment in Studio
-************************************************
+###############################################
 
 .. tags:: educator, how-to
 
 .. contents::
   :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<Upload a 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 <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<Designing a Peer Instruction 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<Upload a 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
 

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**.
+#. Click **Save**.
+
+.. seealso::
+ :class:dropdown
+
+ :ref:`Working with Problem Components`