Assessment Library Update (#437)

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

* **Documentation**
* Reorganized and expanded Assessments Library guides into clearer
stepwise and tabbed workflows (add/update/unlink)
* Renamed and restructured "Add Questions" guidance for clarity, layout,
tagging, and dependency handling
* Expanded Global and Search docs with filter categories, saved-search
management, examples, and workflow updates
  * Added/updated illustrative images and captions for key steps
* Removed the Organization Assessments Library link from Organization
settings navigation

<sub>✏️ Tip: You can customize this high-level summary in your review
settings.</sub>
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: LolaValente

source/img/DisconnectFromlib.png

@@ -18,7 +18,6 @@ Organization settings
    enable-custom-script
    grade-templates
    remove-org-members
-   create-org-library
    public-private-settings
    gigabox-usage
    delete-org

source/img/UpdateInLib.png

@@ -3,27 +3,37 @@
 
 .. _add-questions-to-library:
 
-Add Questions to an Assessments Library
-=======================================
-Once an assessment is added to an assessment library, it can be accessed later and added to a project or course. 
+Add Questions to an Assessment Library
+======================================
 
-**Prerequisite:**
-Before you can add questions to an assessment library, an Admin in your organization must create an organization assessments library. See :ref:`Create an Organization Assessments Library <org-library>` for more information.
+You can add assessments to a library to reuse them across multiple projects and courses.
 
-Follow these steps to add questions to your assessments library:
 
-1. Create the assessment (see :ref:`Add a New Assessment <add-assessment>`) for the assignment and be sure to keep the following in mind:
+.. important:: Before you can add questions to an assessment library, an Admin in your organization must create an organization assessments library. See :ref:`Create an Organization Assessments Library <org-library>` for more information.
 
-  - Assessments on pages set to the :ref:`*1 Panel without tree* layout <layout>` are saved with a :ref:`simple layout <add-questions-from-library>`.
+How to Add Questions to a Library
+---------------------------------
 
-  - Use the **Metadata** tab to tag your assessment so it appears when the :ref:`searching the assessments library <search-library>`.
+1. Create the assessment (see :ref:`Add a New Assessment <add-assessment>`). Keep the following in mind:
+
+   **Layout considerations:**
+   
+   - Assessments on pages using the :ref:`1 Panel without tree layout <layout>` are saved with a :ref:`simple layout <add-questions-from-library>`.
+
+   **Tagging for searchability:**
+   
+   - Use the **Metadata** tab to tag your assessment so it appears when :ref:`searching the assessments library <search-library>`.
+
+   **Including dependencies:**
+   
+   - Use the **Files** tab to include all dependent files (grading scripts, images, etc.) so the assessment works properly when added from the library.
 
-  - Use the **Files** tab to ensure all dependent files, such as grading scripts, images used in the guides pane, etc. are associated with the assessment so it works properly when added from the library.
 
 2. Once the assessment is created, click **Save in Library** in the lower right corner on the assessment page.
 
    .. image:: /img/guides/assessment-save-to-library.png
       :alt: Save in Library
+      :width: 450px
 
 3. On the **Select Library** dialog, choose the library from the drop-down list.
 
@@ -35,6 +45,6 @@ Follow these steps to add questions to your assessments library:
    .. image:: /img/guides/assessment-library-selection.png
       :alt: Select Library
 
-   If you receive an error message, ensure that you have write access to your organization's assessment library. See :ref:`Create an Organization Assessments Library <org-library>` for more information.
+.. warning:: If you receive an error message, ensure that you have write access to your organization's assessment library. See :ref:`Create an Organization Assessments Library <org-library>` for more information.
 
 5. Once a question has been added, follow the steps in :ref:`Update an Existing Assessment from Library <update-library>` to update your assessment with the newly added question.

source/img/guides/UpdateInLib.png

@@ -11,6 +11,7 @@ Assessments Libraries
    :hidden:
 
    global-library
+   ../../admin/organization/create-org-library
    search-library
    add-questions-from-library
    add-questions-to-library
@@ -24,7 +25,3 @@ You can also use the assessment libraries with the :ref:`Random Assessment <rand
 
 You can organize your library by course number, programming language, department, etc. and filter the library based on tags when searching for assessments.
 
-
-
-
-

source/img/guides/assessment-save-to-library.png

@@ -4,39 +4,90 @@
 .. _global-library:
 
 Codio Global Assessments Library
-================================
-The Global Assessments Library is an assessment library to which all Codio users have *read-only* access. The library contains auto-graded assessment questions that cover a wide variety of topics, difficulties, and assessment types. We are currently populating it with assessments in:
+=================================
+
+The Global Assessments Library is an assessment library to which all Codio users have **read-only access**. The library contains auto-graded assessment questions that cover a wide variety of topics, difficulties, and assessment types.
+
+Current Coverage
+----------------
+
+We are currently populating it with assessments in:
 
 - Java
 - C / C++
 - Python
 - JavaScript
 - Data Structures (in Java)
 
-All assessments in the global library are auto-graded, contain example solutions and answer explanations for the student, and some include teacher notes to help better convey the intended learning objective of the assessment.
+Assessment Features
+-------------------
+
+All assessments in the global library are auto-graded and contain example solutions and answer explanations for students. Some assessments also include teacher notes to help better convey the intended learning objective.
+
 
 Using the Global Assessments Library
 ------------------------------------
+
 To access the Codio Global Assessments Library, follow these steps:
 
-1. Click the **Assessments** button and choose **Assessment** from the **Add from Library** area
-2. On the **Choose an Assessment to Add** dialog, click the **Library Name** drop-down and choose **Codio Main**.
-3. You can filter through the different assessments by tags:
+1. From the course dashboard navigate to **Edit Assignments**. 
+2. Click and Open an Assignment. 
+3. Click **Edit**. 
+4. Click the **Assessments** button and choose **Assessment** from the **Add from Library** section.
+5. On the **Choose an Assessment to Add** dialog, click the **Library Name** drop-down and choose **Codio Main**.
+6. You can filter through the different assessments by tags:
 
-   .. image:: /img/bloomsTax.png
-      :alt: Bloom's Taxonomy
+.. image:: /img/bloomsTax.png
+   :alt: Bloom's Taxonomy
+   :width: 650px
 
-  - Programming language
-  - Assessment type (auto-detected)
-  - Category (topic-level)
-  - Content (sub-topic level)
-  - Learning Objective (in SWBAT form - "Students will be able to....")
-  - Bloom's Taxonomy level
+
+.. list-table:: Filter Categories and Inputs
+   :widths: 30 70
+   :header-rows: 1
+
+   * - Category
+     - Available Inputs & Description
+   * - Bloom's Taxonomy Level
+     - Level I - Remembering
+       
+       Level II - Understanding
+       
+       Level III - Applying
+       
+       Level IV - Analyzing
+       
+       Level V - Evaluating
+       
+       Level VI - Creating
+   * - Assessment Type (auto-detected)
+     - Standard Code Test
+       
+       Advanced Code Test
+       
+       Parsons Puzzle
+       
+       Multiple Choice
+       
+       Fill in the Blanks
+       
+       Free Text Autograde
+   * - Programming Language
+     - Select the programming language for code-based assessments (e.g., Python, Java, C++, JavaScript)
+   * - Category (topic-level)
+     - Broad subject area or topic category for filtering assessments (e.g., variables, functions, loops)
+   * - Content (sub-topic level)
+     - Specific subtopic or concept within the category (e.g., modifying variables, creating functions, nesting for loops)
+   * - Learning Objective (SWBAT form)
+     - Define what "Students Will Be Able To..." accomplish after completing the assessment
+       
+       Example: "Students will be able to implement binary search algorithms efficiently"
+
 
 4. Once you find the question you want to add to your assessment, click **Add**.
 
-Modify question from Global Assessment Library
+Modify Question from Global Assessment Library
 ----------------------------------------------
 If you like a question in the Assessments Library but want to modify it, :ref:`unlink <unlink-assessment>` the question from the library and then modify it for your assignment.
 
-You can then add your new version of the assessment to your organization's assessment library.
+You can then add your new version of the assessment to your organization's assessment library. For more information on creating an organization assessments library see :ref:`Organization Assessments Library <org-library>`.

source/instructors/admin/organization/organisation.rst

@@ -5,71 +5,115 @@
 Search Assessments Library
 ==========================
 
-You search an assessment library the same whether you are using Codio's :ref:`Global Assessment Library <global-library>` or your :ref:`organization assessment library <org-library>`. Follow these steps to search a library:
+Searching an assessment library works the same way whether you're using Codio's :ref:`Global Assessment Library <global-library>` or your :ref:`organization assessment library <org-library>`. To search a library, follow these steps:
 
-1. In the Guide Editor, click the **Assessments** button and choose **Assessment** from the **Add from Library** area.
+1. From the course dashboard navigate to **Edit Assignments**. 
+
+2. Click and Open an Assignment. 
+
+3. Click **Edit**. 
+
+4. In the Guide Editor, click the **Assessments** button and choose **Assessment** from the **Add from Library** area.
 
-2. Click the **Library Name** drop-down and choose the assessments library you want to search.
+5. Click the **Library Name** drop-down and choose the assessments library you want to search.
 
    .. image:: /img/selectLib.png
       :alt: Select Library
 
-3. To narrow the assessments that are displayed, enter a tag and value pair. For example, you can search by the **Programming Language** (tag) and indicate you want **Python** (value) questions. The search is not case sensitive and Codio presents auto-complete suggestions as you type.
+
+6. To narrow the displayed assessments, enter a tag and value pair. For example, select **Programming Language** as the tag and **Python** as the value. The search is not case sensitive, and Codio provides auto-complete suggestions as you type.
 
    .. image:: /img/autoComplete.png
       :alt: Autocomplete
 
-   You can also click any of the tag fields in the results to automatically filter and add a new row (click +) to your search query. You can add as many tag:value pairs as needed to narrow your search.
 
-   .. image:: /img/doubleTags.png
-      :alt: Add Tags
+.. tab-set::
+
+   .. tab-item:: Filter Categories
+
+      .. list-table:: Filter Categories and Inputs
+         :widths: 30 70
+         :header-rows: 1
+
+         * - Category
+           - Available Inputs & Description
+         * - Bloom's Taxonomy Level
+           - Level I - Remembering
+             
+             Level II - Understanding
+             
+             Level III - Applying
+             
+             Level IV - Analyzing
+             
+             Level V - Evaluating
+             
+             Level VI - Creating
+         * - Assessment Type (auto-detected)
+           - Standard Code Test
+             
+             Advanced Code Test
+             
+             Parsons Puzzle
+             
+             Multiple Choice
+             
+             Fill in the Blanks
+             
+             Free Text Autograde
+         * - Programming Language
+           - Select the programming language for code-based assessments (e.g., Python, Java, C++, JavaScript)
+         * - Category (topic-level)
+           - Broad subject area or topic category for filtering assessments (e.g., variables, functions, loops)
+         * - Content (sub-topic level)
+           - Specific subtopic or concept within the category (e.g., modifying variables, creating functions, nesting for loops)
+         * - Learning Objective (SWBAT form)
+           - Define what "Students Will Be Able To..." accomplish after completing the assessment
+             
+             Example: "Students will be able to implement binary search algorithms efficiently"
+
+   .. tab-item:: Using Multiple Filters
 
-   Once you have completed entering tag and value pairs, the results are displayed.
+      **Adding multiple filters:**
+      
+      - Click any tag field in the results to automatically add it to your search query
+      - Click the **+** button to add a new row for additional tag and value pairs
+      - Add as many tag and value pairs as needed to refine your search
 
-   .. image:: /img/searchResults.png
-      :alt: Search Results
+      .. image:: /img/doubleTags.png
+         :alt: Add Tags
 
-4. Scroll through the search results using the scroll bar or use the navigation buttons in the upper portion of the page to move forward, back, or to a specific page.
+      The results update automatically based on your selected filters.
 
-   .. image:: /img/scrollThrough.png
-      :alt: Scroll Results
+      .. image:: /img/searchResults.png
+         :alt: Search Results
 
-5. Click an assessment to preview the question.
 
-   .. image:: /img/previewQuestion1.png
-      :alt: Preview Question
+Managing Saved Searches
+-----------------------
 
-   If you preview a second question, the first preview collapses.
+.. tab-set::
 
-   .. image:: /img/previewQuestion2.png
-      :alt: Preview Collapsed
+   .. tab-item:: Saving Searches
 
-Saving searches
----------------
-If you want to save search parameters, follow these steps:
+      If you want to save search parameters, follow these steps:
 
-1. Click the **Save** button to the right of the tags and values.
+      1. Click the **Save** button to the right of the tags and values.
 
-   .. image:  /img/doubleTags2.png
-      :alt: Save Search
+      2. On the **Save Search** dialog, enter a **Search Name** and click **OK**.
 
-2. On the **Save Search** dialog, enter a **Search Name** and click **OK**.
+         .. image:: /img/nameSearch.png
+            :alt: Search Name
 
-   .. image:: /img/nameSearch.png
-      :alt: Search Name
+   .. tab-item:: Using Saved Searches
 
-Using saved searches
---------------------
-To use a saved search, click the **Saved** drop-down list and choose the saved search.
+      To use a saved search, click the **Saved** drop-down list and choose the saved search.
 
-    .. image: /img/savedSearch.png
-       :alt: Use Saved Search
+      You can edit these search parameters without changing your saved search.
 
-You can edit these search parameters  without changing your saved search.
+   .. tab-item:: Deleting Saved Searches
 
-Delete saved searches
----------------------
-To remove a saved search, click the **Saved** drop-down list and click the red **x** to the name.
+      To remove a saved search, click the **Saved** drop-down list and click the red **x** next to the name.
 
-    .. image:: /img/savedSearchDelete.png
-       :alt: Delete Saved Search
+      .. image:: /img/savedSearchDelete.png
+         :alt: Delete Saved Search

source/instructors/setupcourses/library/add-questions-to-library.rst

@@ -5,25 +5,39 @@
 
 Unlink an Assessment
 ====================
-If you want to modify an assessment that is in the library, you can unlink it, make your changes, and then add your own version to your organization's assessments library. Follow these steps to find the assessment you wish to modify, either:
 
-1. In the Guide Editor, click the **Edit: <Assessment Name>** button to the right of the assesment.
+To modify a library assessment, you must first unlink it from the library. After making changes, you can add your modified version to your organization's assessment library.
 
-   .. image:: /img/guides/editassessmentbutton.png
-      :alt: Edit Assessment
 
-Or 
+Unlink Process
+--------------
 
-2. Click the **Assessment** button to view the list of all assessments and click the assessment to open it.
+1. Choose one of the following methods to find the assessment you want to modify:
 
-   .. image:: /img/guides/editassessmentlist.png
-      :alt: Edit Assessment List
+.. tab-set::
 
-3. To unlink the assessment, open the assessment, 
+   .. tab-item:: From the Guide Editor
 
-4. Click **Disconnect** in the lower right corner.
+      Click the **Edit: <Assessment Name>** button to the right of the assessment.
+
+      .. image:: /img/guides/editassessmentbutton.png
+         :alt: Edit Assessment
+         :width: 450px
+
+   .. tab-item:: From the Assessment List
+
+      Click the **Assessment** button to view all assessments, then click the assessment to open it.
+
+      .. image:: /img/guides/editassessmentlist.png
+         :alt: Edit Assessment List
+
+
+2. To unlink the assessment, open the assessment. 
+
+3. Click **Disconnect** in the lower right corner.
 
    .. image:: /img/DisconnectFromlib.png
       :alt: Disconnect
+      :width: 450px
 
    A message is displayed confirming that the assessment has been successfully disconnected from the appropriate library.