docs: Reorg, Rename, and Fix refs for Single Select, SGA, Text Input,…

… Timed Exams
openedx · Mar 1, 2025 · 7c97465 · 7c97465
1 parent 1078636
commit 7c97465
Show file tree

Hide file tree

Showing 21 changed files with 70 additions and 189 deletions.
diff --git a/...oncepts/advanced_features/timed_exams.rst → ...s/advanced_features/about_timed_exams.rst b/...oncepts/advanced_features/timed_exams.rst → ...s/advanced_features/about_timed_exams.rst
@@ -1,7 +1,7 @@
 .. _Timed Exams:
 
-Timed Exams
-#############
+About Timed Exams
+#################
 
 .. tags:: educator, concept
 
@@ -25,7 +25,7 @@ starting a timed exam.
 .. seealso::
 
 
- :ref:`Configure Timed Exams`
+ :ref:`Manage Timed Exams`
 
 
 

diff --git a/...development/exercise_tools/text_input.rst → ...cepts/exercise_tools/about_text_input.rst b/...development/exercise_tools/text_input.rst → ...cepts/exercise_tools/about_text_input.rst
@@ -1,10 +1,10 @@
 .. _Text Input:
 
 ########################
-Text Input Problem
+About Text Input Problem
 ########################
 
-.. tags:: educator, reference
+.. tags:: educator, concept
 
 The text input problem type is a simple problem type that can be added to any
 course. At a minimum, text input problems include a question or prompt and a

diff --git a/source/educators/concepts/exercise_tools/single_select_overview.rst b/source/educators/concepts/exercise_tools/single_select_overview.rst
@@ -1,7 +1,7 @@
-.. _Single Select Overview:
+.. _About Single Select:
 
-Overview
-#########
+About Single Select Problems
+#############################
 
 .. tags:: educator, concept
 

diff --git a/source/educators/concepts/exercise_tools/staff_graded.rst b/source/educators/concepts/exercise_tools/staff_graded.rst
diff --git a/source/educators/how-tos/add_dropdown.rst b/source/educators/how-tos/add_dropdown.rst
diff --git a/source/educators/how-tos/add_multiple_choice.rst b/source/educators/how-tos/add_multiple_choice.rst
diff --git a/...how-tos/advanced_features/timed_exams.rst → .../advanced_features/manage_timed_exams.rst b/...how-tos/advanced_features/timed_exams.rst → .../advanced_features/manage_timed_exams.rst
@@ -1,7 +1,7 @@
-.. _Configure Timed Exams:
+.. _Manage Timed Exams:
 
 ######################
-Configure Timed Exams
+Manage Timed Exams
 ######################
 
 .. tags:: educator, how-to

diff --git a/source/educators/how-tos/course_development/exercise_tools/add_dropdown.rst b/source/educators/how-tos/course_development/exercise_tools/add_dropdown.rst
@@ -5,6 +5,8 @@ Add a Dropdown Problem
 
 .. tags:: educator, how-to
 
+.. youtube:: e6HxKo18_xE
+
 You add dropdown problems in Studio by selecting the **Problem** component.
 In the problem editor, select the **Dropdown** option. Fill in the fields on
 this screen to create your problem.

diff --git a/source/educators/how-tos/course_development/exercise_tools/add_single_select.rst b/source/educators/how-tos/course_development/exercise_tools/add_single_select.rst
@@ -5,6 +5,8 @@ Add a Single Select Problem
 
 .. tags:: educator, how-to
 
+.. youtube:: ij5VHvY6jBk
+
 You add single select problems in Studio by selecting the **Problem**
 component. In the problem editor, select the **Single select** option.
 Fill in the fields on this screen to create your problem.
@@ -36,7 +38,7 @@ out :ref:`Simple Editor` and :ref:`Guide to Problem Settings`.
 
 .. _Use Feedback in a Single Select Problem:
 
-Adding Feedback
+Add Feedback
 ***************
 
 For an overview of feedback in problems, see :ref:`Adding Feedback and Hints to
@@ -68,7 +70,7 @@ learner submits this answer.
 
 .. _Use Hints in a Single Select Problem:
 
-Adding Hints
+Add Hints
 ************
 
 You can add hints to a single select problem . For an overview of hints in
@@ -77,7 +79,7 @@ problems, see :ref:`Adding Feedback and Hints to a Problem`.
 .. seealso::
 
 
- :ref:`Single Select Overview` (concept)
+ :ref:`About Single Select` (concept)
 
  :ref:`Single Select Problem XML` (reference)
 

diff --git a/...ators/how-tos/course_development/exercise_tools/add_single_select_num_input.rst b/...ators/how-tos/course_development/exercise_tools/add_single_select_num_input.rst
@@ -58,7 +58,7 @@ Single Select and Numerical Input Problem Code
 
  :ref:`Manage Numerical Input Problem` (how-to)
 
- :ref:`Single Select Overview` (concept)
+ :ref:`About Single Select` (concept)
 
  :ref:`Single Select` (how-to)
 

diff --git a/source/educators/how-tos/course_development/exercise_tools/add_text_input.rst b/source/educators/how-tos/course_development/exercise_tools/add_text_input.rst
@@ -1,7 +1,7 @@
 .. _Add Text Input Problem:
 
 ###########################
-Adding a Text Input Problem
+Add a Text Input Problem
 ###########################
 
 .. tags:: educator, how-to
@@ -32,7 +32,7 @@ If you have any questions on the specifics of using the simple editor, please ch
 out :ref:`Simple Editor` and :ref:`Guide to Problem Settings`.
 
 ***************
-Adding Feedback
+Add Feedback
 ***************
 
 For an overview of feedback in problems, see :ref:`Adding Feedback and Hints to
@@ -58,7 +58,7 @@ Simply enter your feedback message in this text field. It will display when the
 learner submits this answer.
 
 ************
-Adding Hints
+Add Hints
 ************
 
 You can add hints to a text input problem using the simple editor or the

diff --git a/...-tos/course_development/exercise_tools/award_partial_credit_multiple_choice.rst b/...-tos/course_development/exercise_tools/award_partial_credit_multiple_choice.rst
@@ -196,7 +196,7 @@ explanation ID.
 .. seealso::
 
 
- :ref:`Single Select Overview` (concept)
+ :ref:`About Single Select` (concept)
 
  :ref:`Single Select` (how-to)
 

diff --git a/...ators/how-tos/course_development/exercise_tools/edit_single_select_advanced.rst b/...ators/how-tos/course_development/exercise_tools/edit_single_select_advanced.rst
@@ -181,7 +181,7 @@ problems, see :ref:`Adding Feedback and Hints to a Problem`.
 .. seealso::
 
 
- :ref:`Single Select Overview` (concept)
+ :ref:`About Single Select` (concept)
 
  :ref:`Single Select` (how-to)
 

diff --git a/...ducators/how-tos/course_development/exercise_tools/edit_text_input_advanced.rst b/...ducators/how-tos/course_development/exercise_tools/edit_text_input_advanced.rst
@@ -48,7 +48,7 @@ You can see the OLX for the example problem from the Overview section below.
   switch back to the simple editor.
 
 
-Adding Feedback
+Add Feedback
 *****************
 
 In the advanced editor, you configure answer feedback with the following syntax.
@@ -87,14 +87,14 @@ common incorrect answers.
 
 
 
-Adding Hints
+Add Hints
 *************
 
 For an overview of hints in problems, see
 :ref:`Adding Feedback and Hints to a Problem`.
 
 
-Adding Text after the Response Field
+Add Text after the Response Field
 **************************************
 
 You might want to include a word, phrase, or sentence after the response field
@@ -206,7 +206,7 @@ attribute.
       </problem>
 
 ===============================================================
-Allowing Regular Expressions as Answers for Text Input Problems
+Allow Regular Expressions as Answers for Text Input Problems
 ===============================================================
 
 You can configure a text input problem to allow a regular expression as an

diff --git a/...ent/exercise_tools/create_staffgraded.rst → ...ent/exercise_tools/manage_staffgraded.rst b/...ent/exercise_tools/create_staffgraded.rst → ...ent/exercise_tools/manage_staffgraded.rst
@@ -1,8 +1,8 @@
 .. _StaffGraded:
 
-#######################
-Staff Graded Assignment
-#######################
+################################ 
+Manage Staff Graded Assignment
+################################
 
 .. tags:: educator, how-to
 
@@ -50,10 +50,21 @@ Staff Graded Assignment Settings
    * - ``Problem Weight`` (optional)
      - Enter the number of points possible for this component. The default value is 1.0.
 
-.. seealso::
-
+**********************************************
+Grading Learners in a Staff Graded Assignment
+**********************************************
+
+While your course is running, after learners have had a chance to complete the off-platform assignment you’re grading, you can assign learner grades from the LMS Instructor view of the component as follows:
+
+#. **Export scores.** Download a grading CSV and use this as a template to assign scores for this problem. You can use track/cohort filters to limit to grading only a subset of learners.
+
+#. **(On your own machine) Fill out grades.** Open the CSV in a spreadsheet editor and assign scores to learners via “New Points” field. Leave scores that you don’t want to change blank.
+
+#. **Import scores** Uploading the filled out CSV. Learners will immediately see their grades after import completes. Supports smaller courses - i.e. file sizes up to 4MB. *Note: [Provisionally supported: usage in large courses] To use in larger courses, break up your grade file CSV by rows, and import in separate files -- or use the track & cohort filters to limit to a subset of rows. In this case, keep the header row for each file. This manual approach for larger courses is error prone, so we are making it available as a use-at-your-own-risk feature for advanced users, but don’t explicitly support it.*
+
+#. **Review result** File is uploaded, validated, scores are overwritten for non-blank rows. You’ll get a readout at the bottom of the screen.
+
 
- :ref:`StaffGraded Grading` (concept)
 
 
 

diff --git a/source/educators/how-tos/reusable_content/add_multiple_choice.txt b/source/educators/how-tos/reusable_content/add_multiple_choice.txt
@@ -47,6 +47,6 @@
 
  :ref:`Editing Single Select Problems using the Advanced Editor` (how-to)
 
- :ref:`Add a Dropdown Problem` (how-to)
+ :ref:`Add Dropdown` (how-to)
Original file line number	Diff line number	Diff line change
Expand Up		@@ -47,6 +47,6 @@

		:ref:`Editing Single Select Problems using the Advanced Editor` (how-to)

		:ref:`Add a Dropdown Problem` (how-to)
		:ref:`Add Dropdown` (how-to)