From e7e9bcd4b1962b4f03c52dd013e698748ade7477 Mon Sep 17 00:00:00 2001 From: sarina Date: Thu, 31 Jul 2025 12:16:59 -0400 Subject: [PATCH 1/5] Deprecate all Legacy Libraries pages --- .../course_development/add_components_library.rst | 2 ++ .../how-tos/course_development/create_library.rst | 2 ++ .../how-tos/course_development/delete_library.rst | 2 ++ .../how-tos/course_development/edit_library.rst | 2 ++ .../course_development/export_import_library.rst | 10 +++++----- .../how-tos/course_development/library_access.rst | 11 ++++++----- .../view_content_legacy_library.rst | 4 +++- 7 files changed, 22 insertions(+), 11 deletions(-) diff --git a/source/educators/how-tos/course_development/add_components_library.rst b/source/educators/how-tos/course_development/add_components_library.rst index b66c757cc..92490e60d 100644 --- a/source/educators/how-tos/course_development/add_components_library.rst +++ b/source/educators/how-tos/course_development/add_components_library.rst @@ -60,5 +60,7 @@ a Legacy Library` and :ref:`Get the Latest Version of Library Content Date: Thu, 31 Jul 2025 12:26:05 -0400 Subject: [PATCH 2/5] Add note about Library content needing to be published before syncing --- .../sync_a_library_update_to_your_course.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/source/educators/how-tos/course_development/sync_a_library_update_to_your_course.rst b/source/educators/how-tos/course_development/sync_a_library_update_to_your_course.rst index c863a1a6f..4dfa9fced 100644 --- a/source/educators/how-tos/course_development/sync_a_library_update_to_your_course.rst +++ b/source/educators/how-tos/course_development/sync_a_library_update_to_your_course.rst @@ -5,6 +5,12 @@ Sync a Library update to your course .. tags:: educator, how-to +.. admonition:: Publish Your Updated Library Content + + In order to sync a piece of content within a course to the latest version in + the Library, the updated Library content must first be published before it + will be available to sync within the course. + #. When a piece of content is updated and re-published in a Library, the sync button appears with the text :guilabel:`UPDATE AVAILABLE`. From 1b4b7c137b0a39aee01c3037d5fec1b9e5be6d00 Mon Sep 17 00:00:00 2001 From: sarina Date: Thu, 31 Jul 2025 12:35:24 -0400 Subject: [PATCH 3/5] Add clarifications that taxonomies must be enabled to add tags --- .../library_content_available_tags.png | Bin 161979 -> 161966 bytes .../library_content_tag_display.png | Bin 403016 -> 403003 bytes .../import_export_a_taxonomy.rst | 7 +++++++ .../add_delete_tags_in_library_content.rst | 11 +++++++++++ 4 files changed, 18 insertions(+) diff --git a/source/_images/educator_how_tos/library_content_available_tags.png b/source/_images/educator_how_tos/library_content_available_tags.png index d594dad97da1672bb1c5e4fdc38cd1c4a508da35..5cd36070024e4e67a167cab7c9d29a6fc186fbdb 100644 GIT binary patch delta 363 zcmdn}k#pTg&JA067#SyT<7r|k;?=u6*@jm_`a)(%L`j6Nk5zJhu3lnFep0GlMQ#BD z2uxneYtN`K`7y66lY+uzH9i#<1t6I0#%By+l=A7-+i`)!z`!Q8A~Ve@AhRMhC&DE& zH#M&~Ge6JH($LaIAFB+y&d}o2BIo>EpvDrr;AE&KWI=QdK&xU?b0QIT8Jd_`AX|nc zg`~G6GcC<3D7830r?dpnym!dtppgiTL~~VW&i+f2XwIj delta 390 zcmZ4Yk#qM)&JA067&#_y<7r~qsMo)2vJJ09;N8rSh>{3jAFJg2T)o7U{G?R9irfMQ z5U{bYC`e4sPAySLN=?tqvsHS(d%u!GW{Ry+xT&v!Z-H}aMy5wqQEG6NUr2IQcCuxP zlD!?*vm!Mo!X+~|HLo}`A84kf zp`{Y4Y$TGbp^2FVLOQfKwa7U?7pS+yRw+2SC>3Z(Mt%ucK}lv>npIG0aehu|3DDrs zyiA}PBdC-wP%Z)?X{%&tVxn(|(C1&22{bbiq|sIhVj9Fi49wM7#SyT<7r}PpV?A1*@jm_`a)(%L`j6Nk5zJhu3lnFep0GlMQ#BD z2uxneYtN`K`7y66lY+uzH9i#<1t6I0#%By+l=A7-+i`)!z`!Q8A~Ve@AhRMhC&DE& zH#M&~Ge6JH!ou7}AFB+y&d}o2BIo>EpvDrr;AE&KWI=QdK&xU?b0QIT8JbvFB3p(e zg`~G6GcC<3D7830r?dpj3UGXXI(5VHU=>vk&vHa;-`VF-2} delta 406 zcmdmeM&iU7i49wM7&#_y<7r}X*`>-q*@jml@NQ;EL`j6Nk5zJhu3lnFep0GlMQ#BD z2-w(H6eK2RrZ%l z!dwYeHWEqJ(8R(LAst$rTI8Ic3)EX;s}!7ElnOK?BfkW!pd>Rb%_=ChI6tSf1ZZ$* zUM5hD5md?-C>Mc{v{f=RG0`_f=<_ei1e%!$(g<`BLOc>vk3P_c0s@jEh`>qB1BOTu z(Cc}V Date: Fri, 15 Aug 2025 10:48:03 -0400 Subject: [PATCH 4/5] Explicitly call out references to Legacy Libraries Explicitly call out references to Legacy Libraries --- .../add_components_library.rst | 24 ++++-- .../course_development/create_library.rst | 30 ++++---- .../course_development/delete_library.rst | 16 +++- .../edit_components_library.rst | 2 +- .../course_development/edit_library.rst | 30 +++++--- .../use_randomized_content_blocks.rst | 10 +-- .../export_import_library.rst | 52 ++++++------- .../course_development/library_access.rst | 76 +++++++++---------- .../view_content_legacy_library.rst | 22 ++++-- 9 files changed, 147 insertions(+), 115 deletions(-) diff --git a/source/educators/how-tos/course_development/add_components_library.rst b/source/educators/how-tos/course_development/add_components_library.rst index 92490e60d..ecd9ccd9b 100644 --- a/source/educators/how-tos/course_development/add_components_library.rst +++ b/source/educators/how-tos/course_development/add_components_library.rst @@ -5,32 +5,40 @@ Add Components to a Legacy Library .. tags:: educator, how-to -To add new :ref:`components` to your library, +.. warning:: + + The Legacy Libraries feature will be supported through Ulmo, moving to + unsupported in Verawood. Ulmo will include a one-click migration feature that + will make it easy to convert a Legacy Library into the new Library interface. + + See :ref:`Content Libraries Redesign Teak` for more information. + +To add new :ref:`components` to your legacy library, follow these steps. #. Log in to Studio. -#. Select **Libraries**, then select the library that you want to add +#. Select **Libraries**, then select the legacy library that you want to add components to. #. Select **Add Component**, then select the component type that you want to add under **Add New Component**. -For more information about the types of components you can add to a library, +For more information about the types of components you can add to a legacy library, see these topics. * :ref:`About Text Components` * :ref:`Working with Problem Components` * :ref:`Working with Video Components` -After you add a component to a library, you can edit its settings. These -settings are retained when the component is selected from the library and used +After you add a component to a legacy library, you can edit its settings. These +settings are retained when the component is selected from the legacy library and used in a course. -When a component from the library is used in a randomized content block, you +When a component from the legacy library is used in a randomized content block, you can further edit the component as it exists in the unit, without affecting the -original version in the library. For details, refer to :ref:`Edit Components in -a Legacy Library` and :ref:`Get the Latest Version of Library Content `. +original version in the legacy library. For details, refer to :ref:`Edit Components in +a Legacy Library` and :ref:`Get the Latest Version of Library Content `. .. seealso:: diff --git a/source/educators/how-tos/course_development/create_library.rst b/source/educators/how-tos/course_development/create_library.rst index 00de5dd6d..9f4664b28 100644 --- a/source/educators/how-tos/course_development/create_library.rst +++ b/source/educators/how-tos/course_development/create_library.rst @@ -17,44 +17,44 @@ that can be used in randomized assignments in your courses. See :ref:`Content Libraries Redesign Teak` for more information. -To create a new library, follow these steps. +To create a new legacy library, follow these steps. #. Log in to Studio. #. Select **New Library**. -#. Enter the required information for your new library, then select **Create**. +#. Enter the required information for your new legacy library, then select **Create**. - .. note:: Enter new library information carefully. The values in these - fields become part of the URL for your library, therefore the total + .. note:: Enter new legacy library information carefully. The values in these + fields become part of the URL for your legacy library, therefore the total number of characters in the **Library Name**, **Organization**, and **Library Code** fields must be 65 or fewer. .. image:: /_images/educator_how_tos/ContentLibrary_NewCL.png - :alt: Image of the library creation page. + :alt: Image of the legacy library creation page. :width: 600 - - For **Library Name**, enter the public display name for your library. + - For **Library Name**, enter the public display name for your legacy library. Choose a meaningful name that will help you and other course team members - to identify the library. For example, "Level 200 Math Problems". When you - add a randomized content block to a course unit, you use the library name - to specify this library as a source for the randomized assignment. + to identify the legacy library. For example, "Level 200 Math Problems". When you + add a randomized content block to a course unit, you use the legacy library name + to specify this legacy library as a source for the randomized assignment. - For **Organization**, enter the identifier for your university. For example, enter HarvardX or MITx. Do not include spaces or special characters. - - For **Library Code**, enter an identifier for your library that is unique + - For **Library Code**, enter an identifier for your legacy library that is unique within your organization. This code becomes part of the URL for your - library, so do not include spaces or special characters in the code. + legacy library, so do not include spaces or special characters in the code. 4. Select **Create**. -You see the new library, to which you can now add components. For information -about adding components to a library, see :ref:`Add Components to a Legacy Library`. +You see the new legacy library, to which you can now add components. For information +about adding components to a legacy library, see :ref:`Add Components to a Legacy Library`. -After you create a library, you are automatically assigned an **Admin** role -for the library. For information about adding other users to a library after +After you create a legacy library, you are automatically assigned an **Admin** role +for the legacy library. For information about adding other users to a legacy library after you create it, see :ref:`Give Other Users Access to Your Legacy Library`. diff --git a/source/educators/how-tos/course_development/delete_library.rst b/source/educators/how-tos/course_development/delete_library.rst index ddf83994e..c5d335dde 100644 --- a/source/educators/how-tos/course_development/delete_library.rst +++ b/source/educators/how-tos/course_development/delete_library.rst @@ -5,16 +5,24 @@ Delete a Legacy Library .. tags:: educator, how-to -You cannot delete a library. Instead, you can discontinue use of an unwanted -library. To do so, follow the next steps: +.. warning:: + + The Legacy Libraries feature will be supported through Ulmo, moving to + unsupported in Verawood. Ulmo will include a one-click migration feature that + will make it easy to convert a Legacy Library into the new Library interface. + + See :ref:`Content Libraries Redesign Teak` for more information. + +You cannot delete a legacy library. Instead, you can discontinue use of an unwanted +legacy library. To do so, follow the next steps: #. First, make sure that none of its components are in use in any courses. -#. Delete all components in the library. +#. Delete all components in the legacy library. #. :ref:`Edit the name of the legacy library` to make it clear to other course team -members that the library should not be used as a source of randomized +members that the legacy library should not be used as a source of randomized assignment content in courses. diff --git a/source/educators/how-tos/course_development/edit_components_library.rst b/source/educators/how-tos/course_development/edit_components_library.rst index e05ed291f..bbddb1801 100644 --- a/source/educators/how-tos/course_development/edit_components_library.rst +++ b/source/educators/how-tos/course_development/edit_components_library.rst @@ -19,7 +19,7 @@ refer to the following topics. these updates in the "source" library are not reflected in the course unless you manually update the randomized content block in the course unit. For details about updating library components used in your course to match the - latest version in the library, see :ref:`Get the Latest Version of Library + latest version in the library, see :ref:`Get the Latest Version of Legacy Library Content`. diff --git a/source/educators/how-tos/course_development/edit_library.rst b/source/educators/how-tos/course_development/edit_library.rst index 00376dbaa..bf8f06a7e 100644 --- a/source/educators/how-tos/course_development/edit_library.rst +++ b/source/educators/how-tos/course_development/edit_library.rst @@ -5,32 +5,40 @@ Edit a Legacy Library .. tags:: educator, how-to -After you create a library, the only change you can make to the initial library +.. warning:: + + The Legacy Libraries feature will be supported through Ulmo, moving to + unsupported in Verawood. Ulmo will include a one-click migration feature that + will make it easy to convert a Legacy Library into the new Library interface. + + See :ref:`Content Libraries Redesign Teak` for more information. + +After you create a legacy library, the only change you can make to the initial legacy library information is to the name. However, at any time, you can make changes to the -components in your library, including adding or deleting components or editing +components in your legacy library, including adding or deleting components or editing the settings of components. For details about editing the contents of a -library, see :ref:`Edit Components in a Legacy Library` and :ref:`Add Components to a +legacy library, see :ref:`Edit Components in a Legacy Library` and :ref:`Add Components to a Legacy Library`. -To change the name of a library, follow these steps. +To change the name of a legacy library, follow these steps. #. Log in to Studio. -#. Select **Libraries**, then select the library whose name you want to edit. +#. Select **Libraries**, then select the legacy library whose name you want to edit. -#. Select the **Edit** icon next to the library name. +#. Select the **Edit** icon next to the legacy library name. - The library name field becomes editable. + The legacy library name field becomes editable. .. image:: /_images/educator_how_tos/ContentLibrary_EditName.png - :alt: The Edit icon to the right of the Library Name. + :alt: The Edit icon to the right of the legacy library Name. :width: 300 -#. In the library name field, make edits or enter a new library name. +#. In the library name field, make edits or enter a new legacy library name. -#. Select anywhere outside the library name field to save your changes. +#. Select anywhere outside the legacy library name field to save your changes. -For details about giving other users access to the library, see :ref:`Give +For details about giving other users access to the legacy library, see :ref:`Give Other Users Access to Your Legacy Library`. diff --git a/source/educators/how-tos/course_development/exercise_tools/use_randomized_content_blocks.rst b/source/educators/how-tos/course_development/exercise_tools/use_randomized_content_blocks.rst index e728bc4e3..d0cf8e931 100644 --- a/source/educators/how-tos/course_development/exercise_tools/use_randomized_content_blocks.rst +++ b/source/educators/how-tos/course_development/exercise_tools/use_randomized_content_blocks.rst @@ -34,7 +34,7 @@ these topics. * :ref:`View the Matching Components in a Randomized Content Block` * :ref:`Edit Components in Randomized Content Blocks` -* :ref:`Get the Latest Version of Library Content` +* :ref:`Get the Latest Version of Legacy Library Content` * :ref:`Preview Randomized Content in Student View` * :ref:`View Specific Student Assigned Problems from Randomized Content Block` * :ref:`Adjust Grades for a Problem from a Randomized Content Block` @@ -154,7 +154,7 @@ do for any other component in your course. components from a library, these changes are overwritten. Only changes to a component's **Settings** tab are retained when you update the component. For details about getting the latest versions of library content in a - randomized content block, see :ref:`Get the Latest Version of Library + randomized content block, see :ref:`Get the Latest Version of Legacy Library Content`. The settings of a component that is supplied in a randomized content block are @@ -172,10 +172,10 @@ library, a **Clear** icon is shown next to the setting field. Select **Clear** to restore the library default setting for that field. -.. _Get the Latest Version of Library Content: +.. _Get the Latest Version of Legacy Library Content: -Getting the Latest Version of Library Content -============================================= +Getting the Latest Version of Legacy Library Content +======================================================= If you modify the contents of a library that is referenced by randomized content blocks in one or more courses, those courses do not automatically use diff --git a/source/educators/how-tos/course_development/export_import_library.rst b/source/educators/how-tos/course_development/export_import_library.rst index 7e1677975..98d6a66f0 100644 --- a/source/educators/how-tos/course_development/export_import_library.rst +++ b/source/educators/how-tos/course_development/export_import_library.rst @@ -17,37 +17,37 @@ Exporting and Importing a Legacy Library See :ref:`Content Libraries Redesign Teak` for more information. -You can :ref:`export` and :ref:`import` a +You can :ref:`export` and :ref:`import` a legacy content library in Studio. -.. warning:: When you import a library, the imported library completely - replaces the existing library and its contents. You cannot undo a library +.. warning:: When you import a legacy library, the imported legacy library completely + replaces the existing legacy library and its contents. You cannot undo a legacy library import. Before you proceed, we recommend that you export the current - library, so that you have a backup copy of it. + legacy library, so that you have a backup copy of it. .. _Export a Legacy Library: Export a Legacy Library ************************ -There are several reasons why you might want to export your library. +There are several reasons why you might want to export your legacy library. * To save your work in progress -* To edit the XML in your library directly -* To create a backup copy of your library +* To edit the XML in your legacy library directly +* To create a backup copy of your legacy library * To share with another course team member -When you export your library, Studio creates a **.tar.gz** file (that is, a +When you export your legacy library, Studio creates a **.tar.gz** file (that is, a .tar file compressed using GNU Zip). This export file contains the problems in -the library, including any customizations you made in the library to problem -settings. The export does not include library settings such as user access +the legacy library, including any customizations you made in the legacy library to problem +settings. The export does not include legacy library settings such as user access permissions. -To export a library, follow these steps. +To export a legacy library, follow these steps. #. In Studio, select the **Libraries** tab. -#. Locate the library that you want to export. +#. Locate the legacy library that you want to export. #. From the **Tools** menu, select **Export**. @@ -62,23 +62,23 @@ computer. Import a Legacy Library ************************* -You might want to import a library if you developed or updated library content +You might want to import a legacy library if you developed or updated legacy library content outside of Studio, or if you want to overwrite a problematic or outdated -version of the library. +version of the legacy library. -.. warning:: When you import a library, the imported library completely - replaces the existing library and its contents. You cannot undo a library +.. warning:: When you import a legacy library, the imported legacy library completely + replaces the existing legacy library and its contents. You cannot undo a legacy library import. Before you proceed, we recommend that you export the current - library, so that you have a backup copy of it. + legacy library, so that you have a backup copy of it. -The library file that you import must be a .tar.gz file (that is, a .tar file +The legacy library file that you import must be a .tar.gz file (that is, a .tar file compressed using GNU Zip). This .tar.gz file must contain a library.xml file. -To import a library, follow these steps. +To import a legacy library, follow these steps. #. In Studio, select the **Libraries** tab. -#. Locate the library to which you want to import the new library content. +#. Locate the legacy library to which you want to import the new legacy library content. #. From the **Tools** menu, select **Import**. @@ -91,17 +91,17 @@ To import a library, follow these steps. (Uploading and Unpacking), do not navigate away from the **Library Import** page. Doing so causes the import process to end. You can leave the page only after the Unpacking stage completes. We recommend - that you do not make important changes to the library until all stages of + that you do not make important changes to the legacy library until all stages of the import process have finished. #. When the import process finishes, select **View Updated Library** to view - the imported library. + the imported legacy library. -.. note:: If your imported library includes changes to components that are in - use in a course, the course does not reflect these library updates until you +.. note:: If your imported legacy library includes changes to components that are in + use in a course, the course does not reflect these legacy library updates until you manually update the randomized content block in the course unit. For details - about updating library components used in your course to match the latest - version in the content library, see :ref:`Get the Latest Version of Library + about updating legacy library components used in your course to match the latest + version in the content legacy library, see :ref:`Get the Latest Version of legacy library Content`. .. seealso:: diff --git a/source/educators/how-tos/course_development/library_access.rst b/source/educators/how-tos/course_development/library_access.rst index 282575240..6cdc90172 100644 --- a/source/educators/how-tos/course_development/library_access.rst +++ b/source/educators/how-tos/course_development/library_access.rst @@ -14,44 +14,44 @@ Give Other Users Access to Your Legacy Library See :ref:`Content Libraries Redesign Teak` for more information. -When you create a library, you are automatically assigned an Admin role in that -library. +When you create a legacy library, you are automatically assigned an Admin role in that +legacy library. -You can give other Studio users access to your library. Depending on the level -of access that you give them in the library, additional library users can view -and use library content in courses, edit library content, or add and manage -other library users. All users to whom you give library access must be +You can give other Studio users access to your legacy library. Depending on the level +of access that you give them in the legacy library, additional legacy library users can view +and use legacy library content in courses, edit legacy library content, or add and manage +other legacy library users. All users to whom you give legacy library access must be registered with Studio and have an active account. These are the levels of access for libraries. -* **User** -- Users can view library content and can use library components in - their courses, but they cannot edit the contents of a library. +* **User** -- Users can view legacy library content and can use legacy library components in + their courses, but they cannot edit the contents of a legacy library. -* **Staff** -- Staff can use library components in their courses. In addition, - as content co-authors, they have full editing privileges in a library. +* **Staff** -- Staff can use legacy library components in their courses. In addition, + as content co-authors, they have full editing privileges in a legacy library. -* **Admin** -- Admins have full editing privileges for a library. In addition, - they can add and remove other team members from library access. There must be - at least one user with Admin privileges in a library. +* **Admin** -- Admins have full editing privileges for a legacy library. In addition, + they can add and remove other team members from legacy library access. There must be + at least one user with Admin privileges in a legacy library. .. note:: 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 + legacy library members only with the **User** level of access, after which you can 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 -************************* +********************************* +Add a User to the legacy library +********************************* -To grant a user initial **User** access to a library, follow these steps. +To grant a user initial **User** access to a legacy library, follow these steps. -.. note:: Only library users with the **Admin** level of access can add users - to the library. +.. note:: Only legacy library users with the **Admin** level of access can add users + to the legacy library. -#. Ensure that the new library member has an active Studio account. +#. Ensure that the new legacy library member has an active Studio account. -#. On the Studio home page, select the **Libraries** tab and locate the library +#. On the Studio home page, select the **Libraries** tab and locate the legacy library to which you are adding this user. #. From the **Settings** menu select **User Access**. @@ -60,19 +60,19 @@ To grant a user initial **User** access to a library, follow these steps. #. Enter the new user's email address, then select **ADD USER**. - The new user is added to the list of library members with the **User** level + The new user is added to the list of legacy library members with the **User** level of access. -****************************** -Remove a User from the Library -****************************** +************************************** +Remove a User from the legacy library +************************************** -You can remove users from the library at any time, regardless of the level of +You can remove users from the legacy library at any time, regardless of the level of access that they have. -To remove a user from the library, follow these steps. +To remove a user from the legacy library, follow these steps. -#. In Studio, select the **Libraries** tab and locate your library. +#. In Studio, select the **Libraries** tab and locate your legacy library. #. From the **Settings** menu select **User Access**. @@ -84,21 +84,21 @@ To remove a user from the library, follow these steps. #. Select **Delete**. - The user is removed from the library. + The user is removed from the legacy library. ************************* Add Staff or Admin Access ************************* -The levels of access for libraries are hierarchical. You can add new library +The levels of access for libraries are hierarchical. You can add new legacy library members only with the **User** level of access, after which you can 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. -To give a library member a higher level of access to the library, follow these +To give a legacy library member a higher level of access to the legacy library, follow these steps. -#. In Studio, select the **Libraries** tab and locate your library. +#. In Studio, select the **Libraries** tab and locate your legacy library. #. From the **Settings** menu select **User Access**. @@ -111,7 +111,7 @@ steps. The user's display listing is updated to indicate the new level of access. In addition, their listing now includes a button to remove their current level of access and move them back to their previous level of access. For details - about reducing a user's level of access to a library, see :ref:`Remove Staff + about reducing a user's level of access to a legacy library, see :ref:`Remove Staff or Admin Access`. .. _Remove Staff or Admin Access: @@ -121,12 +121,12 @@ 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. +**Admin** legacy library users) can reduce their levels of access. -To remove **Staff** or **Admin** access from a library user, follow these +To remove **Staff** or **Admin** access from a legacy library user, follow these steps. -#. In Studio, select the **Libraries** tab and locate your library. +#. In Studio, select the **Libraries** tab and locate your legacy library. #. From the **Settings** menu select **User Access**. @@ -138,7 +138,7 @@ steps. The user's display listing is updated to indicate the new role. -.. note:: There must always be at least one Admin for a library. If there is +.. note:: There must always be at least one Admin for a legacy library. If there is only one user with the Admin role, you cannot remove him or her from the Admin role unless you first assign another user to the Admin role. diff --git a/source/educators/how-tos/course_development/view_content_legacy_library.rst b/source/educators/how-tos/course_development/view_content_legacy_library.rst index 5034cbe09..20967e20a 100644 --- a/source/educators/how-tos/course_development/view_content_legacy_library.rst +++ b/source/educators/how-tos/course_development/view_content_legacy_library.rst @@ -5,20 +5,28 @@ View the Contents of a Legacy Library .. tags:: educator, how-to -To view the entire contents of a library in Studio, follow these steps. +.. warning:: + + The Legacy Libraries feature will be supported through Ulmo, moving to + unsupported in Verawood. Ulmo will include a one-click migration feature that + will make it easy to convert a Legacy Library into the new Library interface. + + See :ref:`Content Libraries Redesign Teak` for more information. + +To view the entire contents of a legacy library in Studio, follow these steps. #. Log in to Studio. -#. Select **Libraries**, then select the library whose components you want to +#. Select **Libraries**, then select the legacy library whose components you want to view. -#. Optionally, select **Hide Previews** at the top right of the library page to +#. Optionally, select **Hide Previews** at the top right of the legacy library page to collapse the component previews and see only the list of component display - names. To return to the full preview of components in the library, select + names. To return to the full preview of components in the legacy library, select **Show Previews**. -The components in the library are shown in the order in which they were added, -with the most recently added at the bottom. If your library has more than 10 +The components in the legacy library are shown in the order in which they were added, +with the most recently added at the bottom. If your legacy library has more than 10 components, additional components are shown on other pages. The range of the components shown on the current page, and the total number of @@ -37,7 +45,7 @@ You can navigate through the pages in the following ways. :alt: Image showing a pair of page numbers with the first number circled. :width: 300 -To view the list of matching components in the library, see :ref:`View the +To view the list of matching components in the legacy library, see :ref:`View the Matching Components in a Randomized Content Block`. To view the randomized content that was assigned to a specific learner, see From c3c03d3ec4824412c91f323959b5af4324ec2bd0 Mon Sep 17 00:00:00 2001 From: sarina Date: Mon, 18 Aug 2025 11:48:50 -0400 Subject: [PATCH 5/5] Clarify Legacy Libraries menu from Studio home --- .../how-tos/course_development/add_components_library.rst | 2 +- .../how-tos/course_development/create_library.rst | 2 +- .../educators/how-tos/course_development/edit_library.rst | 2 +- .../how-tos/course_development/export_import_library.rst | 4 ++-- .../how-tos/course_development/library_access.rst | 8 ++++---- .../course_development/view_content_legacy_library.rst | 2 +- 6 files changed, 10 insertions(+), 10 deletions(-) diff --git a/source/educators/how-tos/course_development/add_components_library.rst b/source/educators/how-tos/course_development/add_components_library.rst index ecd9ccd9b..0b81db084 100644 --- a/source/educators/how-tos/course_development/add_components_library.rst +++ b/source/educators/how-tos/course_development/add_components_library.rst @@ -18,7 +18,7 @@ follow these steps. #. Log in to Studio. -#. Select **Libraries**, then select the legacy library that you want to add +#. Select **Legacy Libraries**, then select the legacy library that you want to add components to. #. Select **Add Component**, then select the component type that you want to diff --git a/source/educators/how-tos/course_development/create_library.rst b/source/educators/how-tos/course_development/create_library.rst index 9f4664b28..25765fef6 100644 --- a/source/educators/how-tos/course_development/create_library.rst +++ b/source/educators/how-tos/course_development/create_library.rst @@ -21,7 +21,7 @@ To create a new legacy library, follow these steps. #. Log in to Studio. -#. Select **New Library**. +#. Select **Legacy Libraries**, then **New Library**. #. Enter the required information for your new legacy library, then select **Create**. diff --git a/source/educators/how-tos/course_development/edit_library.rst b/source/educators/how-tos/course_development/edit_library.rst index bf8f06a7e..dfc93ec8c 100644 --- a/source/educators/how-tos/course_development/edit_library.rst +++ b/source/educators/how-tos/course_development/edit_library.rst @@ -24,7 +24,7 @@ To change the name of a legacy library, follow these steps. #. Log in to Studio. -#. Select **Libraries**, then select the legacy library whose name you want to edit. +#. Select **Legacy Libraries**, then select the legacy library whose name you want to edit. #. Select the **Edit** icon next to the legacy library name. diff --git a/source/educators/how-tos/course_development/export_import_library.rst b/source/educators/how-tos/course_development/export_import_library.rst index 98d6a66f0..4a0fdf58d 100644 --- a/source/educators/how-tos/course_development/export_import_library.rst +++ b/source/educators/how-tos/course_development/export_import_library.rst @@ -45,7 +45,7 @@ permissions. To export a legacy library, follow these steps. -#. In Studio, select the **Libraries** tab. +#. In Studio, select the **Legacy Libraries** tab. #. Locate the legacy library that you want to export. @@ -76,7 +76,7 @@ compressed using GNU Zip). This .tar.gz file must contain a library.xml file. To import a legacy library, follow these steps. -#. In Studio, select the **Libraries** tab. +#. In Studio, select the **Legacy Libraries** tab. #. Locate the legacy library to which you want to import the new legacy library content. diff --git a/source/educators/how-tos/course_development/library_access.rst b/source/educators/how-tos/course_development/library_access.rst index 6cdc90172..ff3e66bae 100644 --- a/source/educators/how-tos/course_development/library_access.rst +++ b/source/educators/how-tos/course_development/library_access.rst @@ -51,7 +51,7 @@ To grant a user initial **User** access to a legacy library, follow these steps. #. Ensure that the new legacy library member has an active Studio account. -#. On the Studio home page, select the **Libraries** tab and locate the legacy library +#. On the Studio home page, select the **Legacy Libraries** tab and locate the legacy library to which you are adding this user. #. From the **Settings** menu select **User Access**. @@ -72,7 +72,7 @@ access that they have. To remove a user from the legacy library, follow these steps. -#. In Studio, select the **Libraries** tab and locate your legacy library. +#. In Studio, select the **Legacy Libraries** tab and locate your legacy library. #. From the **Settings** menu select **User Access**. @@ -98,7 +98,7 @@ to people who already have the **Staff** level of access. To give a legacy library member a higher level of access to the legacy library, follow these steps. -#. In Studio, select the **Libraries** tab and locate your legacy library. +#. In Studio, select the **Legacy Libraries** tab and locate your legacy library. #. From the **Settings** menu select **User Access**. @@ -126,7 +126,7 @@ After you have granted users **Staff** or **Admin** access, you (or other To remove **Staff** or **Admin** access from a legacy library user, follow these steps. -#. In Studio, select the **Libraries** tab and locate your legacy library. +#. In Studio, select the **Legacy Libraries** tab and locate your legacy library. #. From the **Settings** menu select **User Access**. diff --git a/source/educators/how-tos/course_development/view_content_legacy_library.rst b/source/educators/how-tos/course_development/view_content_legacy_library.rst index 20967e20a..7220f4f99 100644 --- a/source/educators/how-tos/course_development/view_content_legacy_library.rst +++ b/source/educators/how-tos/course_development/view_content_legacy_library.rst @@ -17,7 +17,7 @@ To view the entire contents of a legacy library in Studio, follow these steps. #. Log in to Studio. -#. Select **Libraries**, then select the legacy library whose components you want to +#. Select **Legacy Libraries**, then select the legacy library whose components you want to view. #. Optionally, select **Hide Previews** at the top right of the legacy library page to