diff --git a/source/img/DisconnectFromlib.png b/source/img/DisconnectFromlib.png index ee08d815..44aaf2e0 100644 Binary files a/source/img/DisconnectFromlib.png and b/source/img/DisconnectFromlib.png differ diff --git a/source/img/UpdateInLib.png b/source/img/UpdateInLib.png deleted file mode 100644 index 15bab567..00000000 Binary files a/source/img/UpdateInLib.png and /dev/null differ diff --git a/source/img/guides/UpdateInLib.png b/source/img/guides/UpdateInLib.png new file mode 100644 index 00000000..40972fef Binary files /dev/null and b/source/img/guides/UpdateInLib.png differ diff --git a/source/img/guides/assessment-save-to-library.png b/source/img/guides/assessment-save-to-library.png index d7365072..ae54db4f 100644 Binary files a/source/img/guides/assessment-save-to-library.png and b/source/img/guides/assessment-save-to-library.png differ diff --git a/source/instructors/admin/organization/organisation.rst b/source/instructors/admin/organization/organisation.rst index c908c0f9..67ee2872 100644 --- a/source/instructors/admin/organization/organisation.rst +++ b/source/instructors/admin/organization/organisation.rst @@ -18,7 +18,6 @@ Organization settings enable-custom-script grade-templates remove-org-members - create-org-library public-private-settings gigabox-usage delete-org diff --git a/source/instructors/setupcourses/library/add-questions-to-library.rst b/source/instructors/setupcourses/library/add-questions-to-library.rst index 8551bde8..ecb3b25c 100644 --- a/source/instructors/setupcourses/library/add-questions-to-library.rst +++ b/source/instructors/setupcourses/library/add-questions-to-library.rst @@ -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 ` 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 `) 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 ` for more information. - - Assessments on pages set to the :ref:`*1 Panel without tree* layout ` are saved with a :ref:`simple layout `. +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 `. +1. Create the assessment (see :ref:`Add a New Assessment `). Keep the following in mind: + + **Layout considerations:** + + - Assessments on pages using the :ref:`1 Panel without tree layout ` are saved with a :ref:`simple layout `. + + **Tagging for searchability:** + + - Use the **Metadata** tab to tag your assessment so it appears when :ref:`searching the assessments 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 ` 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 ` for more information. 5. Once a question has been added, follow the steps in :ref:`Update an Existing Assessment from Library ` to update your assessment with the newly added question. diff --git a/source/instructors/setupcourses/library/assessmentslibrary.rst b/source/instructors/setupcourses/library/assessmentslibrary.rst index 2c3e5289..02dd8722 100644 --- a/source/instructors/setupcourses/library/assessmentslibrary.rst +++ b/source/instructors/setupcourses/library/assessmentslibrary.rst @@ -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 ` 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. \ No newline at end of file +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 `. \ No newline at end of file diff --git a/source/instructors/setupcourses/library/search-library.rst b/source/instructors/setupcourses/library/search-library.rst index c97c8c94..891c03d6 100644 --- a/source/instructors/setupcourses/library/search-library.rst +++ b/source/instructors/setupcourses/library/search-library.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 ` or your :ref:`organization assessment 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 ` or your :ref:`organization assessment 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 \ No newline at end of file diff --git a/source/instructors/setupcourses/library/unlink-assessment.rst b/source/instructors/setupcourses/library/unlink-assessment.rst index d0224129..64a287f1 100644 --- a/source/instructors/setupcourses/library/unlink-assessment.rst +++ b/source/instructors/setupcourses/library/unlink-assessment.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: ** 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: ** 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. \ No newline at end of file diff --git a/source/instructors/setupcourses/library/update-assess-from-library.rst b/source/instructors/setupcourses/library/update-assess-from-library.rst index 6a6a43c7..966bcacf 100644 --- a/source/instructors/setupcourses/library/update-assess-from-library.rst +++ b/source/instructors/setupcourses/library/update-assess-from-library.rst @@ -5,21 +5,32 @@ Update an Existing Assessment in Library ======================================== -If you want to update an assessment that is in the library, follow these steps to find the assessment you wish to modify, either by: -1. In the Guide Editor, click the **Edit: ** button to the right of the assessment. +To update assessments in the library, follow these steps: - .. image:: /img/guides/editassessmentbutton.png - :alt: Edit Assessment +1. Choose one of the following methods to find the assessment you want to update: -Or +.. tab-set:: -2. Click the **Assessment** button to view the list of all assessments and click the assessment to open it. + .. tab-item:: From the Guide Editor - .. image:: /img/guides/editassessmentlist.png - :alt: Edit Assessment List + Click the **Edit: ** button to the right of the assessment. -3. To update the assessment, open the assessment, and click **Update in Library** in the lower right corner. + .. image:: /img/guides/editassessmentbutton.png + :alt: Edit Assessment + :width: 450px - .. image:: /img/UpdateInLib.png + .. 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 update the assessment, open the assessment, and click **Update in Library** in the lower right corner. + + .. image:: /img/guides/UpdateInLib.png :alt: Update in Library + :width: 450px