diff --git a/source/_images/educator_how_tos/migrate_legacy_library_collections.png b/source/_images/educator_how_tos/migrate_legacy_library_collections.png new file mode 100644 index 000000000..62be183db Binary files /dev/null and b/source/_images/educator_how_tos/migrate_legacy_library_collections.png differ diff --git a/source/_images/educator_how_tos/migrate_legacy_library_complete.png b/source/_images/educator_how_tos/migrate_legacy_library_complete.png new file mode 100644 index 000000000..f90e4631b Binary files /dev/null and b/source/_images/educator_how_tos/migrate_legacy_library_complete.png differ diff --git a/source/_images/educator_how_tos/migrate_legacy_library_confirm.png b/source/_images/educator_how_tos/migrate_legacy_library_confirm.png new file mode 100644 index 000000000..f1404d870 Binary files /dev/null and b/source/_images/educator_how_tos/migrate_legacy_library_confirm.png differ diff --git a/source/_images/educator_how_tos/migrate_legacy_library_navigation.png b/source/_images/educator_how_tos/migrate_legacy_library_navigation.png new file mode 100644 index 000000000..c167df19e Binary files /dev/null and b/source/_images/educator_how_tos/migrate_legacy_library_navigation.png differ diff --git a/source/_images/educator_how_tos/migrate_legacy_library_new_details.png b/source/_images/educator_how_tos/migrate_legacy_library_new_details.png new file mode 100644 index 000000000..0a39a0aed Binary files /dev/null and b/source/_images/educator_how_tos/migrate_legacy_library_new_details.png differ diff --git a/source/_images/educator_how_tos/migrate_legacy_library_review.png b/source/_images/educator_how_tos/migrate_legacy_library_review.png new file mode 100644 index 000000000..ee6f65285 Binary files /dev/null and b/source/_images/educator_how_tos/migrate_legacy_library_review.png differ diff --git a/source/_images/educator_how_tos/migrate_legacy_library_select.png b/source/_images/educator_how_tos/migrate_legacy_library_select.png new file mode 100644 index 000000000..28827da15 Binary files /dev/null and b/source/_images/educator_how_tos/migrate_legacy_library_select.png differ diff --git a/source/_images/educator_how_tos/migrate_legacy_library_sync_content.png b/source/_images/educator_how_tos/migrate_legacy_library_sync_content.png new file mode 100644 index 000000000..13388cb77 Binary files /dev/null and b/source/_images/educator_how_tos/migrate_legacy_library_sync_content.png differ diff --git a/source/_images/educator_how_tos/migrate_legacy_library_sync_content_complete.png b/source/_images/educator_how_tos/migrate_legacy_library_sync_content_complete.png new file mode 100644 index 000000000..bd65bb5f2 Binary files /dev/null and b/source/_images/educator_how_tos/migrate_legacy_library_sync_content_complete.png differ diff --git a/source/_images/educator_how_tos/migrate_legacy_new_library.png b/source/_images/educator_how_tos/migrate_legacy_new_library.png new file mode 100644 index 000000000..42b059039 Binary files /dev/null and b/source/_images/educator_how_tos/migrate_legacy_new_library.png differ diff --git a/source/community/release_notes/ulmo/feature_release_notes.rst b/source/community/release_notes/ulmo/feature_release_notes.rst index 34141190c..5d90a22f8 100644 --- a/source/community/release_notes/ulmo/feature_release_notes.rst +++ b/source/community/release_notes/ulmo/feature_release_notes.rst @@ -10,6 +10,7 @@ Open edX Ulmo Release - Product Release Notes .. toctree:: :maxdepth: 1 + ulmo_libraries ulmo_rp ulmo_mobile_updates ulmo_catalog diff --git a/source/community/release_notes/ulmo/ulmo_libraries.rst b/source/community/release_notes/ulmo/ulmo_libraries.rst new file mode 100644 index 000000000..65348db45 --- /dev/null +++ b/source/community/release_notes/ulmo/ulmo_libraries.rst @@ -0,0 +1,18 @@ +.. _Ulmo Libraries: + +Library Updates in the Ulmo Release +################################### + +Build entire course sections once, then reuse them +everywhere — imagine updating your intro module across 20 courses with one +click! + +*Full notes coming soon!* + +**Maintenance chart** + ++--------------+-------------------------------+----------------+---------------------------------------------------+ +| Review Date | Working Group Reviewer | Release |Test situation | ++--------------+-------------------------------+----------------+---------------------------------------------------+ +|2025-12-05 | sarina | Ulmo | Draft | ++--------------+-------------------------------+----------------+---------------------------------------------------+ \ No newline at end of file diff --git a/source/community/release_notes/ulmo/ulmo_marketing_notes.rst b/source/community/release_notes/ulmo/ulmo_marketing_notes.rst index 5f0e5e813..0f989677b 100644 --- a/source/community/release_notes/ulmo/ulmo_marketing_notes.rst +++ b/source/community/release_notes/ulmo/ulmo_marketing_notes.rst @@ -9,7 +9,7 @@ for authors, learners, and site operators. Here's what's ready for you now: 🧑‍🏫 For Course Authors ******************************** -**Advanced Libraries**: Build entire course sections once, then reuse them +:ref:`Advanced Libraries `: Build entire course sections once, then reuse them everywhere — imagine updating your intro module across 20 courses with one click! @@ -34,8 +34,12 @@ delivered both in-platform and via email. ⚙️ For Site Operators ********************** -**Important**: The Ulmo release will require the new theming system. Get ahead -of the curve and test it now so your upgrade is seamless! +**Important**: The Ulmo release will require the :ref:`new theming system `. + +:ref:`More Flexibility To Build Custom Features `: More +plugin slots have been added across the platform to support easier customization +and extension by your development or operations team. 🔮 Upcoming in Verawood (June 2026) ************************************ diff --git a/source/educators/concepts/instructional_design/libraries.rst b/source/educators/concepts/instructional_design/libraries.rst index 4f27c4eff..6917ca968 100644 --- a/source/educators/concepts/instructional_design/libraries.rst +++ b/source/educators/concepts/instructional_design/libraries.rst @@ -9,8 +9,8 @@ Legacy Content Libraries v1 Overview .. 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. + unsupported in Verawood. Ulmo includes a :ref:`one-click migration feature ` + that makes it easy to convert a Legacy Library into the new Library interface. See :ref:`Content Libraries Redesign Teak` for more on the new Libraries initiative. 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 0b81db084..824278d05 100644 --- a/source/educators/how-tos/course_development/add_components_library.rst +++ b/source/educators/how-tos/course_development/add_components_library.rst @@ -8,8 +8,9 @@ Add Components to a Legacy 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. + unsupported in Verawood. Ulmo includes a :ref:`one-click migration feature + ` that makes it easy to convert a Legacy Library + into the new Library interface. See :ref:`Content Libraries Redesign Teak` for more information. diff --git a/source/educators/how-tos/course_development/create_library.rst b/source/educators/how-tos/course_development/create_library.rst index 25765fef6..724157d8c 100644 --- a/source/educators/how-tos/course_development/create_library.rst +++ b/source/educators/how-tos/course_development/create_library.rst @@ -12,8 +12,9 @@ that can be used in randomized assignments in your courses. .. 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. + unsupported in Verawood. Ulmo includes a :ref:`one-click migration feature + ` that makes it easy to convert a Legacy Library + into the new Library interface. See :ref:`Content Libraries Redesign Teak` for more information. diff --git a/source/educators/how-tos/course_development/delete_library.rst b/source/educators/how-tos/course_development/delete_library.rst index c5d335dde..35517ba9b 100644 --- a/source/educators/how-tos/course_development/delete_library.rst +++ b/source/educators/how-tos/course_development/delete_library.rst @@ -8,8 +8,9 @@ Delete a Legacy 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. + unsupported in Verawood. Ulmo includes a :ref:`one-click migration feature + ` that makes it easy to convert a Legacy Library + into the new Library interface. See :ref:`Content Libraries Redesign Teak` for more information. diff --git a/source/educators/how-tos/course_development/edit_library.rst b/source/educators/how-tos/course_development/edit_library.rst index dfc93ec8c..71aa8e34a 100644 --- a/source/educators/how-tos/course_development/edit_library.rst +++ b/source/educators/how-tos/course_development/edit_library.rst @@ -8,8 +8,9 @@ Edit a Legacy 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. + unsupported in Verawood. Ulmo includes a :ref:`one-click migration feature + ` that makes it easy to convert a Legacy Library + into the new Library interface. See :ref:`Content Libraries Redesign Teak` for more information. 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 4a0fdf58d..760bccd33 100644 --- a/source/educators/how-tos/course_development/export_import_library.rst +++ b/source/educators/how-tos/course_development/export_import_library.rst @@ -12,8 +12,9 @@ Exporting and Importing a Legacy 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. + unsupported in Verawood. Ulmo includes a :ref:`one-click migration feature + ` that makes it easy to convert a Legacy Library + into the new Library interface. See :ref:`Content Libraries Redesign Teak` for more information. diff --git a/source/educators/how-tos/course_development/library_access.rst b/source/educators/how-tos/course_development/library_access.rst index ff3e66bae..cec9d69f8 100644 --- a/source/educators/how-tos/course_development/library_access.rst +++ b/source/educators/how-tos/course_development/library_access.rst @@ -9,8 +9,9 @@ Give Other Users Access to Your Legacy 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. + unsupported in Verawood. Ulmo includes a :ref:`one-click migration feature + ` that makes it easy to convert a Legacy Library + into the new Library interface. See :ref:`Content Libraries Redesign Teak` for more information. diff --git a/source/educators/how-tos/course_development/migrate_legacy_libraries.rst b/source/educators/how-tos/course_development/migrate_legacy_libraries.rst new file mode 100644 index 000000000..a95446054 --- /dev/null +++ b/source/educators/how-tos/course_development/migrate_legacy_libraries.rst @@ -0,0 +1,152 @@ +.. _Migrating Legacy Libraries: + +Migrate Legacy Libraries to the New Library Environment +####################################################### + +.. tags:: educator, how-to + +In Verawood, Legacy libraries will no longer be supported. They are being +replaced with the :ref:`new, fully-featured Library experience ` +introduced in Sumac. The new feature allows you to create any type of content in +a library - including content blocks, units, subsections and sections. All +content can be reused across courses. To take full advantage of the new +features, and to continue using the content in your Legacy Libraries, migrate +your Legacy Libraries. + +.. contents:: + :local: + :depth: 1 + +.. _Migrate Legacy Libraries: + +Migrate Legacy Libraries +************************ + +#. Click on the Legacy Libraries tab on Studio Home. You will see a button to + :guilabel:`Review Legacy Libraries`. + + .. image:: /_images/educator_how_tos/migrate_legacy_library_review.png + :alt: The "Review Legacy Libraries" button appears in a warning panel above the list of Legacy Libraries. + +#. Select which Library you wish to migrate. Click the checkbox next to the + Library title to select a Library. You may choose one Library at a time, or + multiple Libraries at once. + + .. note:: + + You can use the search bar to find libraries by keyword, or the filter to scope your view to unmigrated libraries. + + Click :guilabel:`Next`. + + .. image:: /_images/educator_how_tos/migrate_legacy_library_select.png + :alt: The Migrate Legacy Libraries screen, including a search box, filter for migration status, and a list of Legacy Libraries. + +#. *IF* you wish to migrate your Legacy Library to a brand new Library, click :guilabel:`+ Create New Library`. + + .. image:: /_images/educator_how_tos/migrate_legacy_new_library.png + :alt: The "Select Destination" screen, with the "Create New Library" button highlighted. + + Provide the new Library a name, organization and ID and click :guilabel:`Create`, then click :guilabel:`Next`. + + .. image:: /_images/educator_how_tos/migrate_legacy_library_new_details.png + :alt: The "Create New Library" screen, with name, organization, and ID fields visible. + +#. *IF* you wish to migrate your Legacy Library to an existing Library, click + the radio button next to the title of the Library you wish to select and + click :guilabel:`Next`. + +#. Review the migration details and click :guilabel:`Confirm`. + + .. image:: /_images/educator_how_tos/migrate_legacy_library_confirm.png + :alt: The Confirm screen, indicating which library/libraries have been selected and their destination. + +#. You will be redirected away from the Legacy Library environment to the new + Library environment. Your Legacy content will now be populated in the new + Library. + + +.. _Navigate Migrated Library: + +Navigate your new Library +************************* + +#. All of the content from your Legacy Library is viewable from the “All + Content” tab. If you migrated more than one Legacy Library, all of the + content from each Legacy Library can be viewed in aggregate. + + .. image:: /_images/educator_how_tos/migrate_legacy_library_navigation.png + :alt: The landing page for the newly-created Library, with each migrated Legacy Library showing as a distinct collection. + +#. Each Legacy Library can also be viewed as a separate collection within the + new Library. Click on the Collections tab to view each of your Legacy + Libraries. + + .. admonition:: Publish Migrated Content + + All migrated content is created in the "Draft" state in the new Library. It must be :ref:`published ` in order to be reused in courses. + + .. image:: /_images/educator_how_tos/migrate_legacy_library_collections.png + :alt: The "Collections" tab of the newly created Library, with each migrated Legacy Library showing as a distinct collection. + +.. _Confirm Legacy Migration: + +Confirm Legacy migrations are complete +************************************** + +#. Navigate to the Legacy Libraries tab on Studio Home. Each migrated Library will contain a redirect link. + + .. image:: /_images/educator_how_tos/migrate_legacy_library_complete.png + :alt: The Legacy Libraries homescreen. Each migrated Legacy Library contains an indicator on its card that it's been migrated. + +.. _Update Legacy References: + +Update course content referenced in Legacy Libraries +**************************************************** + +#. Navigate to the unit page of the course that references Legacy Library + content. You will see a notification that the Library is no longer supported + and needs to be updated in order to sync any future content changes. Click + “update reference”. + + .. note:: + + Content in the Library must be :ref:`published ` before any references can be synced. + + .. image:: /_images/educator_how_tos/migrate_legacy_library_sync_content.png + :alt: The Studio Unit page of a piece of content that uses content from a Legacy Library. There is a link to "Update reference" from the Legacy Library to the New Library. + +#. You will now see the content referenced in the course. Any future changes + made to the referenced content can now be synced to the course using the :ref:`Sync Content workflows `. + + .. image:: /_images/educator_how_tos/migrate_legacy_library_sync_content_complete.png + :alt: The unit page after the reference has been updated. At this point, there is no indication that the content used to link to a Legacy Library. + + +.. seealso:: + + :ref:`Publish Library content` + + :ref:`Create a New Library` + + :ref:`Create and edit content in a Library` + + :ref:`Create and edit units in a Library` + + :ref:`Search for content in a Library` + + :ref:`Use content sidebars to manage content` + + :ref:`Add Library content to a course` + + :ref:`Sync a Library update to your course` + + :ref:`Add users to Libraries` + + +**Maintenance chart** + ++--------------+-------------------------------+----------------+---------------------------------------------------+ +| Review Date | Working Group Reviewer | Release |Test situation | ++--------------+-------------------------------+----------------+---------------------------------------------------+ +|2025-12-05 | Product WG | Ulmo | Pass | ++--------------+-------------------------------+----------------+---------------------------------------------------+ \ No newline at end of file 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 7220f4f99..20799a96d 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 @@ -8,8 +8,9 @@ View the Contents of a Legacy 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. + unsupported in Verawood. Ulmo includes a :ref:`one-click migration feature + ` that makes it easy to convert a Legacy Library + into the new Library interface. See :ref:`Content Libraries Redesign Teak` for more information. diff --git a/source/educators/how-tos/leveraging_libraries.rst b/source/educators/how-tos/leveraging_libraries.rst index 2a10bbf01..98a801ae9 100644 --- a/source/educators/how-tos/leveraging_libraries.rst +++ b/source/educators/how-tos/leveraging_libraries.rst @@ -5,12 +5,12 @@ Leveraging Legacy Libraries .. warning:: - The Legacy Libraries feature will be supported through Teak, moving to - unsupported in Ulmo. Teak will include a one-click migration feature that - will make it easy to convert a Legacy Library into the new Library interface. + The Legacy Libraries feature will be supported through Ulmo, moving to + unsupported in Verawood. Ulmo includes a :ref:`one-click migration feature ` + that makes it easy to convert a Legacy Library into the new Library interface. - See :doc:`/community/release_notes/sumac/content_libraries_redesign_beta` for - more information. + See :ref:`Content Libraries Redesign Teak` for more on the new Libraries + initiative. You can use legacy libraries to organize content into a set of reusable, randomizable components. See the following for details: diff --git a/source/educators/navigation/content_creation_management.rst b/source/educators/navigation/content_creation_management.rst index 7cdb20df4..519dfd89b 100644 --- a/source/educators/navigation/content_creation_management.rst +++ b/source/educators/navigation/content_creation_management.rst @@ -201,8 +201,9 @@ Work with Legacy Content Libraries ********************************** 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. +unsupported in Verawood. Ulmo includes a :ref:`one-click migration feature +` that makes it easy to convert a Legacy Library +into the new Library interface. See :ref:`Content Libraries Redesign Teak` for more on the new Libraries initiative. @@ -211,6 +212,7 @@ initiative. :maxdepth: 1 :glob: + ../how-tos/course_development/migrate_legacy_libraries.rst ../concepts/instructional_design/libraries.rst ../how-tos/course_development/create_library.rst ../how-tos/course_development/edit_library.rst