FC-0068 docs: how-to cleaning by edunext #18

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

@@ -1,8 +1,7 @@
 .. _Problem Written in LaTeX:
 
-############################
 Problem Written in LaTeX
-############################
+########################
 
 .. tags:: educator, how-to
 
@@ -24,9 +23,8 @@ into the LaTeX editor, you make a few adjustments.
 .. image:: /_images/educator_how_tos/ProblemWrittenInLaTeX.png
  :alt: Image of a problem written in LaTeX
 
-************************************
 Create a Problem Written in LaTeX
-************************************
+*********************************
 
 To create a problem written in LaTeX, follow these steps.
 
@@ -47,4 +45,19 @@ To create a problem written in LaTeX, follow these steps.
    file into the editor from your computer by clicking **Upload** in the bottom
    right corner.
 #. In the lower left corner of the LaTeX source compiler, click **Save &
-   Compile to edX XML**.
+   Compile to Open edX XML**.
+
+.. seealso::
+ :class: dropdown
+
+ :ref:`Numerical Input` (reference)
+
+ :ref:`Numerical Input Problem XML` (reference)
+
+ :ref:`Editing Numerical Input Problems using the Advanced Editor` (how-to)
+
+ :ref:`Awarding Partial Credit in a Numerical Input Problem` (how-to)
+
+ :ref:`Work with Latex Code` (how-to)
+
+ :ref:`Adding Numerical Input Problem` (how-to)

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

@@ -1,8 +1,7 @@
 .. _Problem with Adaptive Hint:
 
-################################
 Problem with Adaptive Hint
-################################
+##########################
 
 .. tags:: educator, how-to
 
@@ -14,9 +13,8 @@ input problems or single select problems.
 .. image:: /_images/educator_how_tos/ProblemWithAdaptiveHintExample.png
  :alt: Image of a problem with an adaptive hint
 
-******************************************
 Create a Problem with an Adaptive Hint
-******************************************
+**************************************
 
 To create the problem illustrated above, follow these steps.
 
@@ -66,4 +64,3 @@ To create the problem illustrated above, follow these steps.
  :class: dropdown
 
  :ref:`Problem with Adaptive Hint XML` (reference)
-

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

@@ -1,8 +1,7 @@
 .. _Protein Builder:
 
-############################
 Protex Protein Builder Tool
-############################
+###########################
 
 .. tags:: educator, how-to
 
@@ -16,9 +15,8 @@ a simple line.
 
 .. _Create the Protein Builder:
 
-********************************
 Create the Protein Builder Tool
-********************************
+*******************************
 
 To create the protein builder, follow these steps.
 
@@ -31,7 +29,6 @@ To create the protein builder, follow these steps.
 
 .. _Protein Builder Code:
 
-*************************
 Protein Builder Tool Code
 *************************
 
@@ -101,4 +98,13 @@ In this code:
      * - T
        - W
        - Y
-       - V
+       - V
+
+.. seealso::
+ :class: dropdown
+
+ :ref:`Chemical Equation` (how-to)
+
+ :ref:`Custom JavaScript` (reference)
+
+ :ref:`Gene Explorer` (reference)

source/educators/how-tos/proctored_exams/allow_opt_out_proctored_exam.rst

@@ -1,38 +1,32 @@
 .. _Allow Opting Out of Proctored Exams:
 
-***************************************************
 Allow Opting Out of Proctored Exams
-***************************************************
+###################################
 
 .. tags:: educator, how-to
 
 When a proctored exam opens, by default, verified learners must take the exam
 with proctoring.
 
-If you want to allow Verified or Master's learners the option to take proctored exams
-without proctoring, please contact your edX partner manager to enable this option.
-
 .. note::
    If a learner opts to take an exam without proctoring, the exam will not be
    timed either. In effect, learners who opt out of proctoring will have
    unlimited time to complete the exam and could return to problem sets at
    any time. You can reduce the ability to view the exam by selecting a due
    date for the exam.
 
-.. only:: Open_edX
-
-    To enable the option for learners to opt out of proctored exams for a course,
-    follow these steps.
+To enable the option for learners to opt out of proctored exams for a course,
+follow these steps.
 
-    #. In Studio, select **Settings**, then select **Proctored Exam Settings**.
+#. In Studio, select **Settings**, then select **Proctored Exam Settings**.
 
-    #. Locate the **Allow Opting Out of Proctored Exams** policy key. The default
-       value is ``No``, which requires Verified and Master's learners to take
-       proctored exams with proctoring.
+#. Locate the **Allow Opting Out of Proctored Exams** policy key. The default
+   value is ``No``, which requires Verified and Master's learners to take
+   proctored exams with proctoring.
 
-    #. Change the value of the setting to ``Yes``.
+#. Change the value of the setting to ``Yes``.
 
-    #. Select **Submit**.
+#. Select **Submit**.
 
 .. seealso::
  :class: dropdown
@@ -57,4 +51,4 @@ without proctoring, please contact your edX partner manager to enable this optio
 
  :ref:`RPNow Proctored Session Results File` (reference)
 
- :ref:`Review RP Proctored Session Results` (how-to)
+ :ref:`Review RP Proctored Session Results` (how-to)

source/educators/how-tos/proctored_exams/create_proctored_exam_pt.rst

@@ -1,58 +1,59 @@
 .. _Create a Proctored Exam with Proctortrack:
 
-#########################################
 Create a Proctored Exam with Proctortrack
 #########################################
 
 .. tags:: educator, how-to
-
-After you enable proctored exams with Proctortrack for your course, you can create proctored exams.
 
-To create a proctored exam for Proctortrack, you first create a single Onboarding exam subsection in your course, and then create one or more proctored exam subsections.
+After you enable proctored exams with Proctortrack for your course, you can
+create proctored exams.
 
-The Onboarding exam is a practice proctored experience which ensures the learner’s
-computer passes system requirements and establishes the learner’s identity
-with Verificient by creating an onboarding profile.
+To create a proctored exam for Proctortrack, you first create a single
+Onboarding exam subsection in your course, and then create one or more
+proctored exam subsections.
 
+The Onboarding exam is a practice proctored experience which ensures the
+learner's computer passes system requirements and establishes the learner's
+identity with Verificient by creating an onboarding profile.
 
-*********************************
 Creating an Onboarding Subsection
 *********************************
 
-
 Proctortrack requires all learners to complete an onboarding process before
 they take a proctored exam. In the onboarding process, learners download and
 install the necessary client software and verify their identity with
 Proctortrack.
 
-
-.. note::  Onboarding includes a mandatory identity verification step which
-   establishes an identity baseline with Verificient. This is required to gain access to the first Proctored Exam, and can take 5+ business days for learners to complete, so we recommend you:
+.. note:: Onboarding includes a mandatory identity verification step which
+   establishes an identity baseline with Verificient. This is required to gain
+   access to the first Proctored Exam, and can take 5+ business days for
+   learners to complete, so we recommend you:
 
    * Create an Onboarding subsection in the first section of any course using
      Proctortrack proctoring, as described below.
 
-   * Add in-course messaging that completing Onboarding early is important, and that access to Onboarding requires to be in a paid track (e.g. Verified or Master’s).
-
-   * Nudge learners who have not yet completed Onboarding a week before the first proctored exam.
+   * Add in-course messaging that completing Onboarding early is important.
 
-   This identity baseline is aged off every 1 year. A valid baseline will work across future Proctortrack courses on edX.org as well, but we recommend learners re-take Onboarding as a practice exam in every course, to make sure their current system is still ready for proctoring in advance of each proctored exam.
+   * Nudge learners who have not yet completed Onboarding a week before the
+     first proctored exam.
 
 To set up Proctortrack onboarding for your course, follow these steps.
 
 #. Add and :ref:`develop a subsection <Developing Course Subsections>` as you
    would any other subsection.
 
-   #. Change the name to something clear to learners, like “Proctortrack Onboarding”.
+   #. Change the name to something clear to learners, like “Proctortrack
+      Onboarding”.
 
-   #. As in the note above, add instructions to learners, explaining why it is important to complete Onboarding early.
-
-   #. Position the Onboarding subsection at an early stage in your course - we recommend positioning it in the first section.
+   #. As in the note above, add instructions to learners, explaining why it is
+      important to complete Onboarding early.
 
+   #. Position the Onboarding subsection at an early stage in your course - we
+      recommend positioning it in the first section.
 
 #. Select the **Configure** icon for the subsection.
 
-#.  The **Settings** dialog box opens to the **Basic** tab.
+#. The **Settings** dialog box opens to the **Basic** tab.
 
 #. In the **Grading** section, set the :ref:`assignment type and due date<Set
    the Assignment Type and Due Date for a Subsection>` for the subsection.
@@ -68,7 +69,6 @@ To set up Proctortrack onboarding for your course, follow these steps.
 
 #. Select **Save**.
 
-*************************
 Creating a Proctored Exam
 *************************
 
@@ -103,7 +103,6 @@ Creating a Proctored Exam
 
 .. _specifying_pt_exam_rules_and_exceptions:
 
-*********************************
 Specify Exam Rules and Exceptions
 *********************************
 
@@ -114,20 +113,21 @@ steps.
 
 #. In the course outline, select **Proctoring Settings**.
 
-   The Verificient Proctortrack dashboard opens in a new browser window. Navigate to this window.
+   The Verificient Proctortrack dashboard opens in a new browser window.
+   Navigate to this window.
 
-#. (optional) Open the **Identify Verification** tab. Select the identity verification rules that you
-   want to enforce for the in-exam identity check and disable the rules that you do not want to enforce.
+#. (optional) Open the **Identify Verification** tab. Select the identity
+   verification rules that you want to enforce for the in-exam identity check
+   and disable the rules that you do not want to enforce.
 
-#. (optional) Open the **Test Settings** tab. Select
-   the rules that you want to enforce for the proctored exam and disable
-   the rules that you do not want to enforce.
+#. (optional) Open the **Test Settings** tab. Select the rules that you want to
+   enforce for the proctored exam and disable the rules that you do not want to
+   enforce.
 
 #. (optional) Open the **Student Settings** tab. Specify any per-learner special
-   exam exemptions and accommodations (Test Settings, Whitelist Url/Apps, or Special Notes
-   for custom student needs). This information will be sent over to the exam reviewers along
-   with the learner’s attempt.
-
+   exam exemptions and accommodations (Test Settings, Whitelist Url/Apps, or
+   Special Notes for custom student needs). This information will be sent over
+   to the exam reviewers along with the learner's attempt.
 
 .. seealso::
  :class: dropdown
@@ -152,4 +152,4 @@ steps.
 
  :ref:`RPNow Proctored Session Results File` (reference)
 
- :ref:`Review RP Proctored Session Results` (how-to)
+ :ref:`Review RP Proctored Session Results` (how-to)

source/educators/how-tos/proctored_exams/create_proctored_exam_rpnow.rst

@@ -1,6 +1,5 @@
 .. _Create a Proctored Exam with RPNow:
 
-##################################
 Create a Proctored Exam with RPNow
 ##################################
 
@@ -11,14 +10,14 @@ exam or a practice exam using your choice of either RPNow or Proctortrack.
 To create a proctored exam or a practice proctored exam for RPNow, follow these
 steps.
 
-  .. note::
-    Practice proctored exams are visible to all learners, regardless of
-    enrollment track.
+.. note::
+   Practice proctored exams are visible to all learners, regardless of
+   enrollment track.
 
 #. Add and :ref:`develop a subsection <Developing Course Subsections>` as you
    would any other subsection.
 
-   For a practice proctored exam, edX recommends that you include only a few
+   For a practice proctored exam, it is recommended that you include only a few
    problems in this subsection. Or, you could add a unit with a text component
    that provides information about the exam.
 
@@ -52,20 +51,20 @@ steps.
    to allow for the exam as HH:MM, where HH is hours and MM is minutes.
 
 #. (optional) For a proctored exam, in the **Review Rules** field, enter any
-   additions or exceptions to the :ref:`default rules for proctored exams<Online Proctoring Rules>`. 
-   For more information, see :ref:`specifying_exam_rules_and_exceptions`.
+   additions or exceptions to the :ref:`default rules for proctored exams
+   <Online Proctoring Rules>`. For more information, see
+   :ref:`specifying_exam_rules_and_exceptions`.
 
 #. Select **Save**.
 
 .. _specifying_exam_rules_and_exceptions:
 
-*********************************
 Specify Exam Rules and Exceptions
 *********************************
 
 By default, reviewers evaluate exam attempts according to a standard set of
-:ref:`online proctoring rules <Online Proctoring Rules>` that the
-proctoring service has provided.
+:ref:`online proctoring rules <Online Proctoring Rules>` that the proctoring
+service has provided.
 
 .. note::
   The course grace period setting does not apply to proctored exams. For more
@@ -78,11 +77,10 @@ exam.
 
 To specify custom proctored exam rules, follow these steps.
 
-  .. note::
-
-    Your additional rules must be clear, specific, and easy to understand so
-    that reviewers do not incorrectly review a learner’s exam. Use simple
-    sentences and words for a global English speaking audience.
+.. note::
+   Your additional rules must be clear, specific, and easy to understand so
+   that reviewers do not incorrectly review a learner's exam. Use simple
+   sentences and words for a global English speaking audience.
 
 #. In Studio, open your course outline and select the subsection for the exam.