temp: fix files in this commit

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

@@ -1,8 +1,7 @@
 .. _RecommenderXBlock:
 
-##################
 Recommender Tool
-##################
+################
 
 .. tags:: educator, how-to
 
@@ -14,9 +13,8 @@ and the learners.
   :local:
   :depth: 2
 
-***********
 Overview
-***********
+********
 
 The most common use of the recommender is for remediation of errors and
 misconceptions, followed by providing additional, more advanced resources.
@@ -54,9 +52,8 @@ assure that they are accessible before making them available through your
 course. For more information, see :ref:`Accessibility Best Practices for Course
 Content Development`.
 
-**************************************************
 Enable the Recommender Tool
-**************************************************
+***************************
 
 Before you can add a recommender component to your course, you must enable the
 recommender tool in Studio.
@@ -66,9 +63,8 @@ the **Advanced Module List** on the **Advanced Settings** page. (Be sure to
 include the quotation marks around the key value.) For more information, see
 :ref:`Enable Additional Exercises and Tools`.
 
-********************************
 Add a Recommender
-********************************
+*****************
 
 To add a recommender to a course, follow these steps.
 
@@ -86,9 +82,11 @@ To add a recommender to a course, follow these steps.
      first time. If selected, the first time (and only the first time) a user
      sees the recommender, there will be a short guided tutorial.
 
+.. REVIEW Remove edX Reference!
+
    * Whether to disable the user interface functions which are under
      development. Because these are untested and under development, please leave
-     these disabled unless otherwise advised by edX staff.
+     these disabled unless otherwise advised by Open edX staff.
 
    * How many resources you want to show in each page of the resource list.
 
@@ -98,4 +96,15 @@ To add a recommender to a course, follow these steps.
 
 #. Select **Save**.
 
-#. Optionally, open the unit in the LMS and suggest some resources.
+#. Optionally, open the unit in the LMS and suggest some resources.
+
+.. seealso::
+ :class: dropdown
+
+ :ref:`Notes Tool` (how-to)
+
+ :ref:`Annotation` (how-to)
+
+ :ref:`Calculator` (how-to)
+
+ :ref:`Enable Completion` (how-to)

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

@@ -2,9 +2,8 @@
 
 .. _Use Components from Libraries in a Course:
 
-*****************************************
 Use Components from Libraries in a Course
-*****************************************
+#########################################
 
 .. tags:: educator, how-to
 
@@ -15,7 +14,7 @@ team who have **Admin** access to that library can grant you access.
 
 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`.
 
 Using components from content libraries in your course involves two steps.
 
@@ -37,11 +36,14 @@ these topics.
 * :ref:`View Specific Student Assigned Problems from Randomized Content Block`
 * :ref:`Adjust Grades for a Problem from a Randomized Content Block`
 
+.. REVIEW Split this!
+.. file1 - Enable Content Libraries
+.. file2 - Edit Components in Randomized Content Blocks
+
 .. _Enable Content Libraries:
 
-************************************************
 Enable Content Libraries
-************************************************
+************************
 
 Before you can add a randomized content blocks to your course, you must enable
 the content library tool in Studio.
@@ -52,7 +54,6 @@ information, see :ref:`Enable Additional Exercises and Tools`.
 
 .. _Add a Randomized Content Block to Your Course:
 
-=============================================
 Add a Randomized Content Block to Your Course
 =============================================
 
@@ -77,22 +78,22 @@ component.
 #. In the randomized content block settings, specify the details of the content
    you want to add in this block.
 
-  - For **Count**, enter the number of problems to display to each student.
+   - For **Count**, enter the number of problems to display to each student.
 
-  - For **Display Name**, enter the name that you want students to see for this
-    block.
+   - For **Display Name**, enter the name that you want students to see for this
+     block.
 
-  - For **Library**, select the library from which you want to draw problems.
+   - For **Library**, select the library from which you want to draw problems.
 
-  - For **Problem Type**, from the drop down list select a specific type of
-    problem to be drawn from the library. Select **Any Type** if you do not
-    want to specify a particular type of problem.
+   - For **Problem Type**, from the drop down list select a specific type of
+     problem to be drawn from the library. Select **Any Type** if you do not
+     want to specify a particular type of problem.
 
-    .. image:: /_images/educator_how_tos/ContentLibraries_RCBSelectProblemType.png
-     :alt: Problem type dropdown list in randomized content block settings.
+     .. image:: /_images/educator_how_tos/ContentLibraries_RCBSelectProblemType.png
+      :alt: Problem type dropdown list in randomized content block settings.
 
-  - For **Scored**, from the drop down list select **True** or **False** to
-    indicate whether the assignment should be graded.
+   - For **Scored**, from the drop down list select **True** or **False** to
+     indicate whether the assignment should be graded.
 
    .. note:: Grading is subject to the setting of this unit's subsection. If the
       subsection is not graded, selecting **True** here has no impact. If the
@@ -111,9 +112,8 @@ Contents of a Library`.
 
 .. _View the Matching Components in a Randomized Content Block:
 
-***********************************************************
 View the Matching Components in a Randomized Content Block
-***********************************************************
+**********************************************************
 
 In a unit that uses a randomized content block, you can view the list of all
 components that match the filters specified in that block.
@@ -145,9 +145,8 @@ To view the randomized content that was assigned to a specific learner, see
 
 .. _Edit Components in Randomized Content Blocks:
 
-******************************************************
 Editing Components in Randomized Content Blocks
-******************************************************
+***********************************************
 
 In Studio, in the course unit that uses a randomized content block, you can
 edit each component within the randomized content block in the same way as you
@@ -178,7 +177,6 @@ Select **Clear** to restore the library default setting for that field.
 
 .. _Get the Latest Version of Library Content:
 
-*********************************************
 Getting the Latest Version of Library Content
 *********************************************
 
@@ -235,31 +233,26 @@ with the version in the library.
 
 .. _Preview Randomized Content in Student View:
 
-***********************************************
 Preview the Randomized Content in Student View
-***********************************************
+**********************************************
 
 You can preview course content before a course is live or before you publish
 specific units, to test how content will appear to students when it is
 released. To view the number and type of components from a randomized content
 block as students would see them, follow the steps described in the
 :ref:`Preview a Unit` topic.
 
-
 .. _View Specific Student Assigned Problems from Randomized Content Block:
 
-***************************************************************************
 View a Specific Student's Assigned Problems from a Randomized Content Block
 ***************************************************************************
 
 In a live course, to view the components that are assigned to a specific
 student from a randomized content block, follow the steps described in the
 :ref:`Specific Student View` topic.
 
-
 .. _Adjust Grades for a Problem from a Randomized Content Block:
 
-***********************************************************
 Adjust Grades for a Problem from a Randomized Content Block
 ***********************************************************