.. _Content Libraries Redesign Teak:

The Content Libraries Redesign Initiative
#############################################

Overview
**********

The Content Libraries redesign project includes a suite of new features and
functionality that make Libraries centralized hubs for creating, managing and
reusing content.

In Sumac, :ref:`Phase 1 <Content Libraries Redesign Beta>` of the Content
Libraries redesign project launched, which included the ability to create and
reuse components, add tags, search and create collections. See :ref:`this
document to explore the various ways to use Libraries <Difference between legacy
and new libraries>`.

What's in Teak?
****************

The Teak release expands Library support to units. Content authors can create a
unit in a Library using the same workflows that they use to create units in
courses. 

..  image:: /_images/release_notes/teak/library_unit_support.png
 :alt: A screenshot showing units within a library

A unit within a library:

..  image:: /_images/release_notes/teak/unit_within_a_library.png

Creating units in a library unlocks benefits such as:

* Authors can create units independently from the course outline. They aren't
  constrained by a prescribed course structure.

* Authors can create content more efficiently, with reuse in mind.

* Authors can reuse units in one or many courses, and sync updates centrally.
  This eliminates duplicative manual workflows.

* Authors can reuse units over and over again, without needing to rebuild them
  every time. 

What are some of the ways I can use this new functionality?

* “All the courses in my physics department use the same introductory material.
  I can create my introductory units once, and reuse them as many times as I
  need.”

* “I'd like to create sets of formative assessments that I can use multiple
  times through a learning sequence.”

* “My instructional designers create the majority of my course content, but we
  have an institutional set of materials that must be included in all courses,
  and updates to this material must be managed centrally.”

New Functionality for Unit Support
*************************************

Expanded content creation means authors can :ref:`create units directly in a
Library <Create and edit units in a Library>`.

All **content management functionality** extends to units, including:

* Units can be :ref:`searched, sorted and filtered <Search for content in a Library>`, enabling easy discovery and management

* Units can be added to :ref:`collections <Build a Collection in a Library>`

* Units can be :ref:`tagged <Add and Delete tags in Library content>`

* Units can be :ref:`published <Publish Library content>`

* Units can be :ref:`reused in courses <Add Library content to a course>`

* Units can be updated in a library and :ref:`synced centrally <Sync a Library update to your course>`

New additions and enhancements to Libraries
*********************************************

Libraries now support more content types, including:

* Open Response Assessment (ORA)

* Drag and Drop

* Polls and Surveys

* Word Cloud

* Google Integration blocks

..  image:: /_images/release_notes/teak/new_additions_and_enhancements_to_libraries.png

Future improvements
**********************

* Libraries will support the creation and reuse of subsections and sections

* Libraries will support import of course content

* Libraries can be exported

* Improvements to the problem randomization workflow

* Improvements to the Library sync page

Migration of Legacy Libraries
*******************************

The Legacy Libraries feature will be supported through Ulmo, moving to
unsupported in Verawood. Ulmo will include a migration feature that will make it
easy to convert a Legacy Library into the new Library interface.

.. seealso::

    :ref:`Navigate the Library Homepage`

    :ref:`Build a Collection in a Library`

    :ref:`Create and edit content in a Library`

    :ref:`Create and edit units in a Library`

    :ref:`Use content sidebars to manage content`

    :ref:`Add Library content to a course`

    :ref:`Add users to Libraries`

**Maintenance chart**

+--------------+-------------------------------+----------------+------------------------------------+
| Review Date  | Working Group Reviewer        |   Release      |Test situation                      |
+--------------+-------------------------------+----------------+------------------------------------+
|2025-12-18    | BTR WG                        | Ulmo           | Deprecated: Not the latest release |
+--------------+-------------------------------+----------------+------------------------------------+
| 2025-06-05   | Product WG                    | Teak           |  Pass                              |
+--------------+-------------------------------+----------------+------------------------------------+