From 8681158010bef6f9064fd6d434d83780fd0d2e61 Mon Sep 17 00:00:00 2001 From: Jesica Greco Date: Fri, 6 Dec 2024 14:30:03 -0300 Subject: [PATCH 01/45] cleanup for howtos3 cleaning up drag_and_drop_deprecated.rst doc --- .../how-tos/drag_and_drop_deprecated.rst | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/source/educators/how-tos/drag_and_drop_deprecated.rst b/source/educators/how-tos/drag_and_drop_deprecated.rst index af504e8bb..3c9b42bd1 100644 --- a/source/educators/how-tos/drag_and_drop_deprecated.rst +++ b/source/educators/how-tos/drag_and_drop_deprecated.rst @@ -39,9 +39,9 @@ objects to a specific location on an image. .. image:: /_images/educator_how_tos/DragAndDropProblem.png :alt: Image of a drag and drop problem. -********************************* +****************************** Adding a Drag and Drop Problem -********************************* +****************************** Before you can include problems that use this deprecated problem type in your course, you must configure your course to :ref:`add unsupported problems @@ -93,9 +93,9 @@ to drag labels onto, and then create a problem component. #. Click **Save**. -========================================== +================================= Sample Drag and Drop Problem Code -========================================== +================================= To create the drag and drop problem that appears in the image above, you download two files from edX, upload these files to the **Files & Uploads** @@ -157,9 +157,9 @@ page, and then add the code for the problem to a problem component. .. _Drag and Drop Problem XML: -********************************* +************************* Drag and Drop Problem XML -********************************* +************************* .. code-block:: xml @@ -237,9 +237,9 @@ Drag and Drop Problem XML -======== +==== Tags -======== +==== * ````: Indicates that the problem is a custom response problem. @@ -353,9 +353,9 @@ the base image. (none) -********************** +********************* Targets on Draggables -********************** +********************* Sometimes it is not enough to have targets only on the base image, and all of the draggables on these targets. If a complex problem exists where a draggable @@ -379,9 +379,9 @@ you will be specifying inner target position coordinates. Use the ``x`` and ``y`` attributes to set the offset of the inner target from the upper-left corner of the parent draggable (that contains the inner target). -===================================== +==================================== Limitations of targets on draggables -===================================== +==================================== * Currently there is a limitation to the level of nesting of targets. @@ -406,9 +406,9 @@ Limitations of targets on draggables nesting (draggables on the base image). In this case the client side will be reporting (x,y) positions of each draggable on the base image. -********************** +********************* Correct answer format -********************** +********************* For specifying answers for targets on draggables, see `Answer format for targets on draggables`_. @@ -624,9 +624,9 @@ Grading logic #. For every group, lists of targets are compared using the rule for that group. -========================== +========================= Set and ``+number`` cases -========================== +========================= ``set()`` and ``+number`` are needed only for the case of reusable draggables. For other cases there are no equal draggables in list, so set() does nothing. From 4233ab1f131d79f2aff326b4be229fadebe2aa47 Mon Sep 17 00:00:00 2001 From: Jesica Greco Date: Fri, 6 Dec 2024 14:52:02 -0300 Subject: [PATCH 02/45] cleaning up for adding_mathjax.rst --- .../course_development/exercise_tools/adding_mathjax.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/educators/how-tos/course_development/exercise_tools/adding_mathjax.rst b/source/educators/how-tos/course_development/exercise_tools/adding_mathjax.rst index 73c9833b1..571b89334 100644 --- a/source/educators/how-tos/course_development/exercise_tools/adding_mathjax.rst +++ b/source/educators/how-tos/course_development/exercise_tools/adding_mathjax.rst @@ -1,8 +1,8 @@ .. _Adding MathJax: -************************************* +################################# Adding MathJax to Text Components -************************************* +################################# .. tags:: educator, how-to @@ -14,9 +14,9 @@ HTML view. Text component editor visual view and HTML view are shown at the top, with the rendered text and equation on the Studio unit page and in the LMS below. -***************************************** +************************************ Adding MathJax to Problem Components -***************************************** +************************************ In the problem component editor, you can use MathJax in either the simple editor or advanced editor. From 1f2692e34b23f523be91159ee4cc0e2491862785 Mon Sep 17 00:00:00 2001 From: Jesica Greco Date: Fri, 6 Dec 2024 14:59:55 -0300 Subject: [PATCH 03/45] cleanup for adding_numerical_input_problem.rst --- .../add_numerical_input_problem.rst | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/source/educators/how-tos/course_development/exercise_tools/add_numerical_input_problem.rst b/source/educators/how-tos/course_development/exercise_tools/add_numerical_input_problem.rst index 99aa0c8c8..fd85dabc7 100644 --- a/source/educators/how-tos/course_development/exercise_tools/add_numerical_input_problem.rst +++ b/source/educators/how-tos/course_development/exercise_tools/add_numerical_input_problem.rst @@ -1,8 +1,8 @@ .. _Adding Numerical Input Problem: -*********************************** +################################ Adding a Numerical Input Problem -*********************************** +################################ .. tags:: educator, how-to @@ -35,9 +35,9 @@ Creating a numerical input problem is as simple as: If you have any questions on the specifics of using the simple editor, please check out :ref:`Simple Editor` and :ref:`Problem Settings`. -============================================================ +***************************** Adding a Tolerance or a Range -============================================================ +***************************** To give learners the option to receive full credit for a close approximation of the correct answer, and to support a wide range of possible correct numerical @@ -51,9 +51,9 @@ to mark as correct for the numerical input problem type. .. note:: You can either have a **tolerance** or an **answer range** for a numerical input problem. You cannot add both. -------------------- +================== Adding a Tolerance -------------------- +================== You can specify a margin of error or tolerance for learner responses. You can specify a percentage or number. The tolerance settings panel can be @@ -63,9 +63,9 @@ found to the right of the editor. :alt: An example tolerance setting set to 5%. :width: 200 --------------------------------------- +========================== Specifying an Answer Range --------------------------------------- +========================== You can specify an answer range so that any learner response within that range is marked correct. @@ -95,9 +95,9 @@ For example, to identify the correct answers as 5, 6, or 7, but not 8, specify .. :diataxis-type: how-to .. _Use Feedback in a Numerical Input Problems: -================= +=============== Adding Feedback -================= +=============== For an overview of feedback in problems, see :ref:`Adding Feedback and Hints to a Problem`. In numerical input problems, you can provide feedback for correct @@ -122,9 +122,9 @@ learner submits this answer. .. _Use Hints in a Numerical Input Problem: -================= +============ Adding Hints -================= +============ You can add hints to a numerical input problem using the simple editor or the advanced editor. For an overview of hints in problems, see From 2e0b4ae4f531ffdcf5b271bee36b6d9c8045d0e4 Mon Sep 17 00:00:00 2001 From: Jesica Greco Date: Fri, 6 Dec 2024 15:16:55 -0300 Subject: [PATCH 04/45] cleaning up for add_text_input.rst doc --- .../exercise_tools/add_text_input.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) 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 index 1eb48b91a..81a40a69b 100644 --- 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,8 +1,8 @@ .. _Add Text Input Problem: -****************************** +########################### Adding a Text Input Problem -****************************** +########################### .. tags:: educator, how-to @@ -31,9 +31,9 @@ Creating a text input problem is as simple as: If you have any questions on the specifics of using the simple editor, please check out :ref:`Simple Editor` and :ref:`Problem Settings`. -============================= +*************** Adding Feedback -============================= +*************** For an overview of feedback in problems, see :ref:`Adding Feedback and Hints to a Problem`. In text input problems, you can provide feedback for the correct @@ -57,9 +57,9 @@ right of the answer text. Simply enter your feedback message in this text field. It will display when the learner submits this answer. -============================= +************ Adding Hints -============================= +************ You can add hints to a text input problem using the simple editor or the advanced editor. For an overview of hints in problems, see From 98c01f9dd5c798d075a90a9f772ccc080570f60b Mon Sep 17 00:00:00 2001 From: Jesica Greco Date: Fri, 6 Dec 2024 15:30:29 -0300 Subject: [PATCH 05/45] cleaning up for library_access.rst --- .../course_development/library_access.rst | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/source/educators/how-tos/course_development/library_access.rst b/source/educators/how-tos/course_development/library_access.rst index 4d575ab9c..776d05ab4 100644 --- a/source/educators/how-tos/course_development/library_access.rst +++ b/source/educators/how-tos/course_development/library_access.rst @@ -1,8 +1,8 @@ .. _Give Other Users Access to Your Library: -*************************************** +####################################### Give Other Users Access to Your Library -*************************************** +####################################### .. tags:: educator, how-to @@ -32,9 +32,9 @@ These are the levels of access for libraries. give them the **Staff** level of access. You can give the **Admin** level of access only to people who already have the **Staff** level of access. -========================= +************************* Add a User to the Library -========================= +************************* To grant a user initial **User** access to a library, follow these steps. @@ -55,9 +55,9 @@ To grant a user initial **User** access to a library, follow these steps. The new user is added to the list of library members with the **User** level of access. -============================== +****************************** Remove a User from the Library -============================== +****************************** You can remove users from the library at any time, regardless of the level of access that they have. @@ -78,9 +78,9 @@ To remove a user from the library, follow these steps. The user is removed from the library. -========================= +************************* Add Staff or Admin Access -========================= +************************* The levels of access for libraries are hierarchical. You can add new library members only with the **User** level of access, after which you can give them @@ -108,9 +108,9 @@ steps. .. _Remove Staff or Admin Access: -============================ +**************************** Remove Staff or Admin Access -============================ +**************************** After you have granted users **Staff** or **Admin** access, you (or other **Admin** library users) can reduce their levels of access. From 3863871ed1cd1165d2cf319157b37d8502643e18 Mon Sep 17 00:00:00 2001 From: Jesica Greco Date: Mon, 9 Dec 2024 11:23:53 -0300 Subject: [PATCH 06/45] cleaning up for add_beta_testers.rst --- .../releasing-course/add_beta_testers.rst | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/source/educators/how-tos/releasing-course/add_beta_testers.rst b/source/educators/how-tos/releasing-course/add_beta_testers.rst index fae6e5be7..425f464df 100644 --- a/source/educators/how-tos/releasing-course/add_beta_testers.rst +++ b/source/educators/how-tos/releasing-course/add_beta_testers.rst @@ -1,14 +1,14 @@ .. _Add_Beta_Testers: -############################# +############################ Add Beta Testers to a Course -############################# +############################ .. tags:: educator, how-to -================================ +******************************** Define When the Beta Test Starts -================================ +******************************** To define the start of the beta test, you use Studio to specify a number of days before the course start date for self-paced courses or before the section @@ -24,9 +24,9 @@ information, see :ref:`How_Testers_See_Course`. .. _Add_Testers: -********************************* +=================== Adding Beta Testers -********************************* +=================== Before you can add beta testers: @@ -52,9 +52,9 @@ When you add beta testers, note the following. .. _Add_Testers_Bulk: -================================ +************************* Add Multiple Beta Testers -================================ +************************* If you have a number of beta testers that you want to add, you can use the "batch add" option to add them all at once, rather than individually. With this @@ -100,9 +100,9 @@ testers**. enrolled in the course. -================================ +***************************** Add Beta Testers Individually -================================ +***************************** #. View the live version of the course. @@ -130,9 +130,9 @@ user's email address. .. _Issue_Reporting_During_Course: -********************************* +******************************** Reporting Issues During a Course -********************************* +******************************** Despite the efforts of the course team and the beta testers, additional problems, questions, and issues can occur while a course is running. From ba9f72b02d8a33f96caad42766cc8e6198281e3e Mon Sep 17 00:00:00 2001 From: Jesica Greco Date: Mon, 9 Dec 2024 15:33:26 -0300 Subject: [PATCH 07/45] cleaning up set_licensing.rst --- source/educators/how-tos/set_licensing.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/educators/how-tos/set_licensing.rst b/source/educators/how-tos/set_licensing.rst index b0cb47b02..d41d71998 100644 --- a/source/educators/how-tos/set_licensing.rst +++ b/source/educators/how-tos/set_licensing.rst @@ -1,8 +1,8 @@ .. _Set Course Content Licensing: -************************************** +====================================== Set Course Content Licensing in Studio -************************************** +====================================== .. tags:: educator, how-to @@ -46,9 +46,9 @@ videos. Learners see the license at the bottom of all pages in the course. .. _Set Video Licensing: -************************************* +******************* Set Video Licensing -************************************* +******************* If you intend for a specific video to have a different license than the course as a whole, you must set the license in the :ref:`video settings