Update Entrance Exams page

Author: sarina

source/_images/educator_how_tos/entrance_exam_in_outline.png

@@ -8,7 +8,8 @@ Require an Entrance Exam
 
 .. admonition:: Turn on the Entrance Exam feature
 
-   In order for the Entrance Exam feature to work, it must be enabled on your Open edX instance.
+   In order for the Entrance Exam feature to work, it must be enabled on your Open edX instance. It is not enabled by default.
+
    Please contact your site administrator to enable the `FEATURES['ENTRANCE_EXAMS'] <https://docs.openedx.org/projects/edx-platform/en/latest/references/featuretoggles.html#featuretoggle-FEATURES['ENTRANCE_EXAMS']>`_ flag.
 
 To require an entrance exam, follow these steps.
@@ -18,47 +19,64 @@ To require an entrance exam, follow these steps.
 #. On the **Schedule & Details** page, locate the **Requirements** section.
 #. Select the **Require students to pass an exam before accessing course
    materials** option.
+
+   .. image:: /_images/educator_how_tos/require_entrance_exam.png
+      :alt: The "Require students to pass an exam before accessing course materials" checkbox appears at the bottom of the "Requirements" section.
+
+#. In the **Grade Requirements** section, set the percentage score required to
+   pass the exam (default is 50%).
 #. Select **Save Changes**.
 
-After you save your changes, Studio automatically creates an **Entrance Exam**
-section in your course outline. To add content to your entrance exam, go to the
+After changes are saved, Studio automatically creates an **Entrance Exam**
+section in the course outline. To add content to the entrance exam, go to the
 course outline.
 
 ***********************
 Create an Entrance Exam
 ***********************
 
-You create your course entrance exam from the course outline in Studio.
+Adding as Entrance Exam automatically places a new section called "Entrance
+Exam" at the top of the course outline.
+
+.. image:: /_images/educator_how_tos/entrance_exam_in_outline.png
+   :alt: The "Entrance Exam" appears as a section at the top of the course outline, above all other course sections
+
+
 Creating entrance exam content is just like creating other course content. For
 more information, see the section on :ref:`Content Creation and Management <Content Creation and Management TOC>`.
 
 **********************************
 Adjust Scores in the Entrance Exam
 **********************************
 
-If you find an error in the exam after learners have taken it, and corrections
-to the exam are unavoidable, you have several options to rescore the exam for
-individual learners. These options are available on the instructor dashboard.
+If the exam is changed or corrected after learners take the exam, there are
+several options to rescore the exam for individual learners. These options are
+available on the instructor dashboard.
 
 In the LMS, select **Instructor** to access the instructor dashboard, and then
 select **Student Admin**. In the **Entrance Exam Grade Adjustment** section,
 the following options are available.
 
-* **Reset Student Attempts**: Reset the value for one particular learner's
+.. image:: /_images/educator_how_tos/entrance_exam_inst_dash.png
+   :alt: The Entrance Exam Grade Adjust section of the Instructor Dashboard
+
+* **Attempts**: Reset the value for one particular learner's
   attempts back to zero so that the learner can begin work over again. For more
   information, see :ref:`reset_attempts`.
 
-* **Rescore Student Submission**: Rescore the responses that a learner has
-  submitted. For more information, see :ref:`rescore`.
+* **Allow Skip**: Waive the requirement for the learner to take the exam.
 
-* **Delete Student State for Problem**: Delete a learner's entire history for
-  the exam from the database. For more information, see :ref:`delete_state`.
+* **Rescore**: Rescore any responses that have been submitted. The 'Rescore All
+  Problems Only If Score Improves' option updates the learner's scores only if
+  it improves in the learner's favor. For more information, see :ref:`rescore`.
 
-Another option on the instructor dashboard is **Show Background Task History
-for Student**. If you reset learner attempts, rescore learner submissions, or
-delete learner state, the operation runs in the background. If you want to see
-a record of all the operations that have run for the entrance exam, select
-**Show Background Task History for Student**.
+* **Delete Learner's State**: Delete a learner's entire history for the exam
+  from the database. For more information, see :ref:`delete_state`.
+
+Another option on the instructor dashboard is **Task Status**. If one of the
+above options are selected, the operation runs in the background. If you want to
+see a record of all the operations that have run for the entrance exam, select
+**Show Task Status**.
 
 .. seealso::
 
@@ -71,6 +89,8 @@ a record of all the operations that have run for the entrance exam, select
 +--------------+-------------------------------+----------------+---------------------------------------------------------------+
 | Review Date  | Working Group Reviewer        |   Release      |Test situation                                                 |
 +--------------+-------------------------------+----------------+---------------------------------------------------------------+
+| 2025-11-16   | sarina                        |  Ulmo          | Pass                                                          |
++--------------+-------------------------------+----------------+---------------------------------------------------------------+
 | 03/11/2025   | Leira (Curricu.me)            | Sumac          | Fail (https://github.com/openedx/docs.openedx.org/issues/891) |
 |              |                               |                | (this simply hasn't been tested with the flag on)             |
 +--------------+-------------------------------+----------------+---------------------------------------------------------------+