assessment updates 3 (#433)

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Documentation**
* Restructured assessment guides to concise, reference-style workflows;
collapsed Metadata/Files steps into a single Create action.
* Added a top-level "Grading a Grade Book Assessment" section and
expanded grading narratives and review guidance.
* Standardized image handling (inline with explicit widths), typography
(LaTeX), and cross-references.
* Condensed auto-generation instructions into references to AI
assessment generation; streamlined grader names/options and expanded
partial‑points examples (Python/JS).
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: LolaValente

source/img/guides/assessment_gb_rubric.png

@@ -10,10 +10,10 @@ The advanced code test assessment type allows you to easily implement unit tests
 To ensure that your test scripts run securely and to prevent student access to your testing files or executables, place them in the **.guides/secure** folder. Create a folder if one does not already exist. This folder is not available to students in their assignments and they cannot access it from the command line. Only teachers with editing privileges have access to the **.guides/secure** folder.
 
 
-.. Note::  If your assignment will contain multiple assessments, Code files and Test Cases for individual assessments should be placed in separate folders to avoid compiling all files. 
+.. note::  If your assignment will contain multiple assessments, Code files and Test Cases for individual assessments should be placed in separate folders to avoid compiling all files. 
 
 
-Complete each section to set up your advanced code test. For more information on **General**, **Metadata** and **Files** see :ref:`Assessments <assessments>`.
+Complete each section to set up your advanced code test. For more information on **General**, **Metadata** (Optional) and **Files** (Optional) see :ref:`Assessments <assessments>`.
 
 1. Complete **General**.
 
@@ -27,30 +27,26 @@ Complete each section to set up your advanced code test. For more information on
      - **Python**: `pycodestyle`_ or `UnitTest`_
      - **JavaScript**: `JSHint and JSLint`_
 
-.. Note:: For more information, see the :ref:`test-types` section or click any test name above to navigate directly to that section.
+.. note:: For more information, see the :ref:`test-types` section or click any test name above to navigate directly to that section.
 
 - **Language Assessment Subtype** - Click the drop-down and choose a subtype for the selected language type, if applicable.
 
 - **Timeout** - You can amend the timeout setting for the code to execute. Arrows will allow you to set max 300 (sec). If you require longer, you can manually enter the timeout period.
 
 3. Click **Grading** in the top navigation pane and complete the following fields:
 
-   .. image:: /img/guides/ACTGradingScreen.png
-      :alt: Grading
-      :width: 500px
-
-  - **Points** - The score given to the student if the code test passes. You can enter any positive numeric value. If this assessment should not be graded, enter 0 points.
-  - **Partial Points** - Toggle to enable a percentage of total points to be given based on the percentage correctly answered. Note that it's not enough to turn partial points on; the advanced code test has to be written to handle partial points.  See :ref:`Partial Points <partial-points>` for more information.
-  - **Define Number of Attempts** - enable to allow and set the number of attempts students can make for this assessment. If disabled, the student can make unlimited attempts.
-  - **Show Rationale to Students** - Toggle to display the rationale for the answer to the student. This guidance information will be shown to students after they have submitted their answer and any time they view the assignment after marking it as completed. You can set when to show this selecting from **Never**, **After x attempts**, **If score is greater than or equal to a % of the total** or **Always**
-  - **Rationale** - Enter guidance for the assessment. This is always visible to the teacher when the project is opened in the course or when opening the student's project. 
-  - **Use maximum score** - Toggle to enable assessment final score to be the highest score attained of all runs.
-
-4. **(Optional)** Complete **Metadata**.
+.. image:: /img/guides/ACTGradingScreen.png
+   :alt: Grading
+   :width: 500px
 
-5. **(Optional)** Complete **Files**.
+- **Points** - The score given to the student if the code test passes. You can enter any positive numeric value. If this assessment should not be graded, enter 0 points.
+- **Partial Points** - Toggle to enable a percentage of total points to be given based on the percentage correctly answered. Note that it's not enough to turn partial points on; the advanced code test has to be written to handle partial points.  See :ref:`Partial Points <partial-points>` for more information.
+- **Define Number of Attempts** - enable to allow and set the number of attempts students can make for this assessment. If disabled, the student can make unlimited attempts.
+- **Show Rationale to Students** - Toggle to display the rationale for the answer to the student. This guidance information will be shown to students after they have submitted their answer and any time they view the assignment after marking it as completed. You can set when to show this selecting from **Never**, **After x attempts**, **If score is greater than or equal to a % of the total** or **Always**
+- **Rationale** - Enter guidance for the assessment. This is always visible to the teacher when the project is opened in the course or when opening the student's project. 
+- **Use Maximum Score** - Toggle to enable assessment final score to be the highest score attained of all runs.
 
-6. Click **Create** to complete the process.
+4. Click **Create** to complete the process.
 
 
 See a Working Example

source/img/guides/assessment_mc_exec.png

@@ -95,8 +95,4 @@ Examples of regular expressions supported for blank fields:
 - **Rationale** - Enter guidance for the assessment. This is always visible to the teacher when the project is opened in the course or when opening the student's project. 
 - **Use maximum score** - Toggle to enable assessment final score to be the highest score attained of all runs.
 
-4. **(Optional)** Complete **Metadata**.
-
-5. **(Optional)** Complete **Files**.
-
-6. Click **Create** to complete the process.
+4. Click **Create** to complete the process.

source/img/guides/assessment_mc_grading.png

@@ -51,11 +51,7 @@ Follow these steps to set up a free text assessment manually. For more informati
 
 - **Rationale** - Enter guidance for the assessment. This is visible to the teacher when the project is opened in the course or when viewing the student's project. It can also be shown to students after submission or when they revisit the assignment after marking it as completed.
 
-3. **(Optional)** Complete **Metadata**.
-
-4. **(Optional)** Complete **Files**.
-
-5. Click **Create** to complete the process.
+3. Click **Create** to complete the process.
 
 
 Grading Free Text Assessments

source/img/guides/parsonspuzzlegrading.png

@@ -5,51 +5,39 @@
 
 Grade Book
 ==========
-A Grade Book assessment may be used to manually grade assignments, it will not appear in the student guides. When the instructor opens a student assignment, the Grade Book is available for rubric based grading. Comments, points, and rubric items are visible to the student when the assessment is graded and the grades are released.  Grade Book assessments do not show in the total assessment count on student/teacher dashboard.
+A Grade Book assessment may be used to manually grade assignments, it will not appear in the student guides. When the instructor opens a student assignment, the Grade Book is available for rubric based grading. Comments, points, and rubric items are visible to the student when the assessment is graded and the grades are released.  Grade Book assessments do not show in the total assessment count on student/teacher dashboard. For more information on **General**, **Metadata** (optional)  and **Files** (optional)  see :ref:`Assessments <assessments>`.
 
-1. On the **General** page, enter a short **Name** that describes the test. This name is displayed in the teacher dashboard and when the teacher is viewing the student work. The name should reflect the challenge and thereby be clear when reviewing. 
 
-   Leaving the name visible will make it easier to locate when grading and we do not recommend toggling the **Show Name** setting to disable it.
-
-   .. image:: /img/guides/assessment_gradebook_general.png
-      :alt: General
+1. Complete **General**. Keep the **Show Name** setting enabled to make submissions easier to locate when grading.
 
 
 2. Click **Grading** in the navigation pane and complete the following fields:
 
-   .. image:: /img/guides/assessment_gradebook_grading.png
-      :alt: Grading
+.. image:: /img/guides/assessment_gradebook_grading.png
+   :alt: Grading
 
-  - **Points** - Enter the score if the student selects the correct answer. You can choose any positive numeric value. If this is an ungraded assessment, enter zero (0).
+- **Points** - Enter the score if the student selects the correct answer. You can choose any positive numeric value. If this is an ungraded assessment, enter zero (0).
 
-  - **Allow Partial Points** - Partial points must be toggled on for this type of assessment. Once you toggle this on, you will be able to add rubric items. Rubric items are negative points, they will be subtracted from the total score of the assessment.
+- **Allow Partial Points** - Partial points must be toggled on for this type of assessment. Once you toggle this on, you will be able to add rubric items. Rubric items are negative points, they will be subtracted from the total score of the assessment.
 
     .. image:: /img/guides/assessment_gb_rubric.png
        :alt: Rubric
+       :width: 350px
 
 
-3. Click **Metadata** in the left navigation pane and complete the following fields:
-
-   .. image:: /img/guides/assessment_metadata.png
-      :alt: Metadata
-
-  - **Bloom's Level** - Click the drop-down and choose the level of Bloom's Taxonomy: https://cft.vanderbilt.edu/guides-sub-pages/blooms-taxonomy/ for the current assessment.
-  - **Learning Objectives** specific educational goal of the current assessment. Typically, objectives begin with Students Will Be Able To (SWBAT). For example, if an assessment asks the student to predict the output of a recursive code segment, then its Learning Objectives could be *SWBAT follow the flow of recursive execution*.
-  - **Tags** - By default, **Content** and **Programming Language** tags are provided and required. To add another tag, click **Add Tag** and enter the name and values.
-
-4. Click **Files** in the left navigation pane and check the check boxes for additional external files to be included with the assessment. The files are then included in the **Additional content** list.
+3. Click **Create** to complete the process.
 
-   .. image:: /img/guides/assessment_files.png
-      :alt: Files
 
-5. Click **Save** to complete the process.
+Grading a Grade Book Assessment
+-------------------------------
 
-The instructor must :ref:`opening a student assignment <viewing-student-work>` to complete the Grade Book grading. Locate the Grade Book assessment in the student file and click **Grade**.
+The instructor must :ref:`open a student assignment <viewing-student-work>` to complete the Grade Book grading. Locate the Grade Book assessment in the student file and click **Grade**.
 
-    .. image:: /img/guides/assessment_gb_opengb.png
-       :alt: Grade book assessment
+.. image:: /img/guides/assessment_gb_opengb.png
+   :alt: Grade book assessment
 
 Click on the 0 or 1 to allocate initial points for overall correctness and then use the other rubric items to subtract points for missing items. There is also a **Points adjust** field if you wish to adjust total points upwards.
 
-    .. image:: /img/guides/assessment_gb_grade.png
-       :alt: Grade book assessment
+.. image:: /img/guides/assessment_gb_grade.png
+   :alt: Grade book assessment
+   :width: 700px

source/instructors/authoring/assessments/advanced-code-test.rst

@@ -10,16 +10,16 @@ Math Assessments
 Codio allows you to set and grade math questions for any type and level of mathematics using the **Free Text** assessment. We only offer manual grading of mathematical expressions or proofs.
 
 
-Manually graded assessments using free text
-*******************************************
+Manually Graded Assessments Using Free Text
+-------------------------------------------
 
-To create a manually graded math question, you can use the **Free text** assessment type. This allows the students to enter expressions or even full proofs and worked answers using Latex. For more information about Latex, please :ref:`click here <latex>`. 
+To create a manually graded math question, you can use the **Free text** assessment type. This allows the students to enter expressions or even full proofs and worked answers using LaTeX. For more information about LaTeX, see :ref:`LaTeX <latex>`. 
 
-You can enter Latex in the **Question** and **Rationale** fields.
+You can enter LaTex in the **Question** and **Rationale** fields.
 
-You should also set the **Preview type** drop down to either **Plaintext + Latex** or **Markdown + Latex**. Both of these ensure that the student sees a preview pane beneath their answer entry fully rendered in markdown and/or Latex. Please - :ref:`click here <free-text>` to review the free text assessment.
+You should also set the **Preview type** dropdown to either **Plaintext + LaTeX** or **Markdown + LaTeX**. Both of these ensure that the student sees a preview pane beneath their answer entry fully rendered in markdown and/or LaTeX. See :ref:`Free text assessments <free-text>` for more information.
 
-Multiple choice
-***************
+Multiple Choice
+---------------
 
-You can also use the multiple choice assessment type to create answers containing properly rendered Latex expressions.
+You can also use the multiple choice assessment type to create answers containing properly rendered LaTeX expressions. See :ref:`Multiple Choice <multiple-choice>` for more information.