Libraries concept doc and override docs

source/community/release_notes/sumac/content_libraries_redesign_beta.rst

@@ -13,8 +13,9 @@ Overview: The New Libraries Experience
 ..  image:: /_images/educator_how_tos/library_homepage.png
   :alt: The Library Homepage with content units in individual tiles
 
-The relaunch of Libraries includes a suite of new features and functionality
-that make Libraries centralized hubs for creating, managing and reusing content. 
+The relaunch of :ref:`Content Libraries <Content Libraries Overview>` includes a
+suite of new features and functionality that make Libraries centralized hubs for
+creating, managing and reusing content. 
 
 Authors can create content independently of the course outline, and reuse it in
 as many courses as they'd like, with synced updates. 

source/community/release_notes/teak/libraries_unit_support.rst

@@ -6,7 +6,7 @@ The Content Libraries Redesign Initiative
 Overview
 **********
 
-The Content Libraries redesign project includes a suite of new features and
+The :ref:`Content Libraries redesign project <Content Libraries Overview>` includes a suite of new features and
 functionality that make Libraries centralized hubs for creating, managing and
 reusing content.
 

source/community/release_notes/ulmo/ulmo_libraries.rst

@@ -4,7 +4,7 @@ Library Updates in the Ulmo Release
 ###################################
 
 Ulmo adds authoring support for Sections and Subsections (also known as
-"structural blocks") in Libraries. You can now author all levels of content for
+"structural blocks") in :ref:`Libraries <Content Libraries Overview>`. You can now author all levels of content for
 reuse in courses. Included are improvements to syncing changes made in a Content
 Library to content that has been reused in courses.
 

source/educators/concepts/instructional_design/content_libraries.rst

@@ -0,0 +1,121 @@
+.. _Content Libraries Overview:
+
+Content Libraries Overview
+##########################
+
+.. tags:: educator, concept
+
+In Studio, a Content Library is a centralized repository where you can create,
+manage, and reuse course content across multiple courses. Instead of rebuilding
+the same material in every course, you author content once in a library and add
+it to as many courses as you need. When you update content in a library and
+publish those changes, courses that use that content can sync to the latest
+version centrally.
+
+Content Libraries support all levels of course content, including individual
+components (such as text, problems, and video), units, subsections, and
+sections.
+
+..  image:: /_images/educator_how_tos/library_homepage.png
+  :alt: The Library Homepage with content units in individual tiles
+
+What You Can Do with Content Libraries
+***************************************
+
+Create and Organize Content
+============================
+
+You can author any level of course content directly in a library, using the
+same editing tools available in Studio. Libraries support a wide range of
+content types, including text components, problems, video, Open Response
+Assessments, drag and drop, polls and surveys, word cloud, and Google
+Integration blocks.
+
+Within a library you can organize content using collections, making it easier
+to group and discover related material. You can also add tags to library
+content to support content alignment and discoverability across your
+organization.
+
+Reuse Content Across Courses
+=============================
+
+Once content is published in a library, you can add it to a course just as you
+would add any other content in Studio. A single piece of library content can be
+reused across many courses simultaneously. Because the content remains linked
+to its source library, all courses benefit from updates centrally rather than
+requiring manual edits in each course separately.
+
+Customize Content for a Course
+================================
+
+Library-sourced content can be customized for a specific course without
+unlinking it from the library. The following types of overrides are supported.
+
+* **Title overrides.** You can rename any library-sourced section, subsection,
+  unit, or component in a course. The custom title is preserved when you sync
+  library updates.
+
+* **Text content overrides.** You can edit the text content of a library-sourced
+  text component in a course. Overridden text components are excluded from
+  future content syncs, so your local edits are preserved. For standalone text
+  components, you can also choose at sync time whether to keep your local
+  content or update to the latest library version.
+
+Sync Updates to Courses
+=========================
+
+When content in a library is updated and published, courses that use that
+content are notified that updates are available. Course authors can review the
+changes side-by-side with the current course content before deciding whether to
+accept or ignore each update. Syncing can be initiated from the course outline,
+the unit page, or the Library Updates page (accessible from the
+:guilabel:`Content` menu in Studio).
+
+Accepting a sync on a structural block — such as a section or subsection —
+applies updates to all content within it, except for any components that have
+local overrides.
+
+Who Can Access a Library
+*************************
+
+Libraries have their own :ref:`user access settings <Add users to Libraries>`,
+separate from courses. Access is managed through the Team Management panel in
+the Administrative Console, which is accessible via the :guilabel:`ⓘ Library
+Info` sidebar in Studio. Any change to a user's library access applies to that
+library only and does not affect their access to other libraries or courses.
+
+Libraries use four roles to control what each team member can do.
+
+* **Library User** — can view and use library content in courses.
+* **Library Contributor** — can create and edit content in the library.
+* **Library Author** — can create, edit, and publish content in the library.
+* **Library Admin** — can manage content and control team membership, including
+  adding and removing users and changing roles.
+
+Only Library Admins and global site admins can add or remove team members or
+change their roles.
+
+.. seealso::
+
+   :ref:`Work with Content Libraries` (reference)
+
+   :ref:`Create a New Library` (how-to)
+
+   :ref:`Create and edit content in a Library` (how-to)
+
+   :ref:`Create and edit units in a Library` (how-to)
+
+   :ref:`Create and Edit New Subsections and Sections` (how-to)
+
+   :ref:`Add Library content to a course` (how-to)
+
+   :ref:`Add users to Libraries` (how-to)
+
+
+**Maintenance chart**
+
++--------------+-------------------------------+----------------+--------------------------------+
+| Review Date  | Working Group Reviewer        |   Release      |Test situation                  |
++--------------+-------------------------------+----------------+--------------------------------+
+| 2026-04-08   | sarina                        | Verawood       | Pass                           |
++--------------+-------------------------------+----------------+--------------------------------+

source/educators/concepts/instructional_design/libraries.rst

@@ -40,7 +40,6 @@ The libraries that you create or have access to are listed on the **Libraries**
 tab on the Studio Home page.
 
 .. seealso::
-
 
  :ref:`Content Libraries Redesign Teak`
 

source/educators/how-tos/course_development/add_components_library.rst

@@ -42,8 +42,7 @@ original version in the legacy library. For details, refer to :ref:`Edit Compone
 a Legacy Library` and :ref:`Get the Latest Version of Library Content <Get the Latest Version of Legacy Library Content>`.
 
 
-.. seealso::
-
+.. seealso:: 
 
  :ref:`Content Libraries Redesign Teak`
 

source/educators/how-tos/course_development/override_library_content_title.rst

@@ -0,0 +1,150 @@
+.. _Override the Title of Library-Sourced Content:
+
+Override the Title of Library-Sourced Content
+#############################################
+
+.. tags:: educator, how-to
+
+When you add content from a content library to your course, it is linked to
+its source library and its title reflects whatever was set in the library. You
+can rename that content in your course without unlinking it from the library.
+Title overrides are supported for all library-sourced content, including
+sections, subsections, units, and components.
+
+.. note::
+   Title overrides are available starting with the Verawood release of the
+   Open edX platform.
+
+Prerequisites
+*************
+
+Before you begin, ensure that you have:
+
+- A course open in Studio.
+- At least one section, subsection, unit, or component that was added to the
+  course from a content library.
+
+Override a Title
+****************
+
+The steps for overriding a title depend on the type of content you are
+renaming.
+
+.. note::
+
+   Once you save a title override, there is no indicator in the current release
+   that marks the content as locally renamed. This is planned for a future
+   release.
+
+Rename a Section, Subsection, or Unit
+======================================
+
+#. In Studio, open the course outline.
+
+#. Locate the library-sourced section, subsection, or unit you want to rename.
+
+#. Select the pencil icon (or click the existing title) to make it editable.
+
+   ..  image:: /_images/educator_how_tos/library_CourseOutline-1-PencilIcon.png
+      :alt: The pencil icon appearing next to the title of a subsection within the course outline, to the right of the subsection's name.
+
+#. Enter the new title.
+
+   ..  image:: /_images/educator_how_tos/library_CourseOutline-2-TypeNewName.png
+      :alt: The title is editable in-line in the course outline.
+
+#. Press Enter on your keyboard, or select outside the field, to save the change.
+
+   ..  image:: /_images/educator_how_tos/library_CourseOutline-3-RenameSaved.png
+      :alt: The subsection is now renamed. The change is now staged for publish, indicated by the "Draft (Unpublished Changes)" label.
+
+.. tip::
+
+   The unit, subsection, or section must be re-published for the change to take affect in the LMS.
+
+Rename a non-Text Component
+===========================
+
+#. In Studio, open the unit that contains the library-sourced component you
+   want to rename.
+
+#. Select the pencil icon next to the component's title to make it editable.
+
+   ..  image:: /_images/educator_how_tos/library_UnitPageVideo-1-PencilIcon.png
+      :alt: The pencil icon appears in the top right of the component editor, above the main content.
+
+#. Enter the new title.
+
+   ..  image:: /_images/educator_how_tos/library_UnitPageVideo-2-TypeEdits.png
+      :alt: The new title is entered in the top bar of the component editor.
+
+#. Press Enter on your keyboard, or select outside the field, to save the change.
+
+   ..  image:: /_images/educator_how_tos/library_CourseOutline-3-RenameSaved.png
+      :alt: The component is now renamed. The change is now staged for publish.
+
+The component now displays your custom title in the course. The title in the
+source library is not affected.
+
+.. tip::
+
+   The component must be re-published for the change to take affect in the LMS.
+
+Rename a Text Component
+=======================
+
+#. In Studio, open the unit that contains the library-sourced component you want to rename.
+
+#. Select the pencil icon next to the text component's title to make it editable.
+
+   ..  image:: /_images/educator_how_tos/library_UnitPageText-1-PencilIcon.png
+      :alt: The pencil icon appears in the top right of the component editor, above the main content.
+
+#. Select the pencil icon next to the component's title in the modal.
+
+   ..  image:: /_images/educator_how_tos/library_UnitPageText-2-ModalPencilIcon.png
+      :alt: In the pop-up modal, the title bar of the text component will have a edit icon to the right of the text component's title.
+
+#. Select the checkmark icon to save the new title.
+
+   ..  image:: /_images/educator_how_tos/library_UnitPageText-4-SaveEdit1.png
+      :alt: In the editable field, a checkmark icon (with tooltip "Save") appears inline with the editable field.
+
+#. Select the save button at the bottom of the modal to save the change.
+
+   ..  image:: /_images/educator_how_tos/library_UnitPageText-5-SaveEdit2.png
+      :alt: After saving the title, focus returns to the modal. The Save button in the bottom right corner will save your changes.
+
+.. tip::
+
+   The text component must be re-published for the change to take affect in the LMS.
+
+How Title Overrides Interact with Syncing
+******************************************
+
+When you sync library-sourced content that has a locally overridden title,
+your custom title is always preserved. Syncing never overwrites a title
+override, even if the title has been updated in the source library.
+
+There is one exception: if a piece of content is deleted in the library and
+you accept that sync, the content is removed from your course even if it had
+a local title override.
+
+.. seealso::
+
+   :ref:`Add Library Content to a Course` (how-to)
+
+   :ref:`Sync a Library update to your course` (how-to)
+
+   :ref:`Override Text Content in a Library-Referenced Component` (how-to)
+
+   :ref:`Override Text Content in a Library-Sourced Structural Block` (how-to)
+
+
+**Maintenance chart**
+
++--------------+-------------------------------+----------------+--------------------------------+
+| Review Date  | Working Group Reviewer        |   Release      |Test situation                  |
++--------------+-------------------------------+----------------+--------------------------------+
+| 2026-04-08   | sarina                        | Verawood       | Pass                           |
++--------------+-------------------------------+----------------+--------------------------------+