Skip to content

Commit 82fcecb

Browse files
sarinaclaude
andcommitted
Concept Doc on Content Libraries
Co-authored-by: Claude <noreply@anthropic.com>
1 parent 1a5f5dc commit 82fcecb

6 files changed

Lines changed: 127 additions & 7 deletions

File tree

source/community/release_notes/sumac/content_libraries_redesign_beta.rst

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,9 @@ Overview: The New Libraries Experience
1313
.. image:: /_images/educator_how_tos/library_homepage.png
1414
:alt: The Library Homepage with content units in individual tiles
1515

16-
The relaunch of Libraries includes a suite of new features and functionality
17-
that make Libraries centralized hubs for creating, managing and reusing content.
16+
The relaunch of :ref:`Content Libraries <Content Libraries Overview>` includes a
17+
suite of new features and functionality that make Libraries centralized hubs for
18+
creating, managing and reusing content.
1819

1920
Authors can create content independently of the course outline, and reuse it in
2021
as many courses as they'd like, with synced updates.

source/community/release_notes/teak/libraries_unit_support.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ The Content Libraries Redesign Initiative
66
Overview
77
**********
88

9-
The Content Libraries redesign project includes a suite of new features and
9+
The :ref:`Content Libraries redesign project <Content Libraries Overview>` includes a suite of new features and
1010
functionality that make Libraries centralized hubs for creating, managing and
1111
reusing content.
1212

source/community/release_notes/ulmo/ulmo_libraries.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Library Updates in the Ulmo Release
44
###################################
55

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

Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
.. _Content Libraries Overview:
2+
3+
Content Libraries Overview
4+
##########################
5+
6+
.. tags:: educator, concept
7+
8+
In Studio, a Content Library is a centralized repository where you can create,
9+
manage, and reuse course content across multiple courses. Instead of rebuilding
10+
the same material in every course, you author content once in a library and add
11+
it to as many courses as you need. When you update content in a library and
12+
publish those changes, courses that use that content can sync to the latest
13+
version centrally.
14+
15+
Content Libraries support all levels of course content, including individual
16+
components (such as text, problems, and video), units, subsections, and
17+
sections.
18+
19+
.. image:: /_images/educator_how_tos/library_homepage.png
20+
:alt: The Library Homepage with content units in individual tiles
21+
22+
What You Can Do with Content Libraries
23+
***************************************
24+
25+
Create and Organize Content
26+
============================
27+
28+
You can author any level of course content directly in a library, using the
29+
same editing tools available in Studio. Libraries support a wide range of
30+
content types, including text components, problems, video, Open Response
31+
Assessments, drag and drop, polls and surveys, word cloud, and Google
32+
Integration blocks.
33+
34+
Within a library you can organize content using collections, making it easier
35+
to group and discover related material. You can also add tags to library
36+
content to support content alignment and discoverability across your
37+
organization.
38+
39+
Reuse Content Across Courses
40+
=============================
41+
42+
Once content is published in a library, you can add it to a course just as you
43+
would add any other content in Studio. A single piece of library content can be
44+
reused across many courses simultaneously. Because the content remains linked
45+
to its source library, all courses benefit from updates centrally rather than
46+
requiring manual edits in each course separately.
47+
48+
Customize Content for a Course
49+
================================
50+
51+
Library-sourced content can be customized for a specific course without
52+
unlinking it from the library. The following types of overrides are supported.
53+
54+
* **Title overrides.** You can rename any library-sourced section, subsection,
55+
unit, or component in a course. The custom title is preserved when you sync
56+
library updates.
57+
58+
* **Text content overrides.** You can edit the text content of a library-sourced
59+
text component in a course. Overridden text components are excluded from
60+
future content syncs, so your local edits are preserved. For standalone text
61+
components, you can also choose at sync time whether to keep your local
62+
content or update to the latest library version.
63+
64+
Sync Updates to Courses
65+
=========================
66+
67+
When content in a library is updated and published, courses that use that
68+
content are notified that updates are available. Course authors can review the
69+
changes side-by-side with the current course content before deciding whether to
70+
accept or ignore each update. Syncing can be initiated from the course outline,
71+
the unit page, or the Library Updates page (accessible from the
72+
:guilabel:`Content` menu in Studio).
73+
74+
Accepting a sync on a structural block — such as a section or subsection —
75+
applies updates to all content within it, except for any components that have
76+
local overrides.
77+
78+
Who Can Access a Library
79+
*************************
80+
81+
Libraries have their own :ref:`user access settings <Add users to Libraries>`,
82+
separate from courses. Access is managed through the Team Management panel in
83+
the Administrative Console, which is accessible via the :guilabel:`ⓘ Library
84+
Info` sidebar in Studio. Any change to a user's library access applies to that
85+
library only and does not affect their access to other libraries or courses.
86+
87+
Libraries use four roles to control what each team member can do.
88+
89+
* **Library User** — can view and use library content in courses.
90+
* **Library Contributor** — can create and edit content in the library.
91+
* **Library Author** — can create, edit, and publish content in the library.
92+
* **Library Admin** — can manage content and control team membership, including
93+
adding and removing users and changing roles.
94+
95+
Only Library Admins and global site admins can add or remove team members or
96+
change their roles.
97+
98+
.. seealso::
99+
100+
:ref:`Work with Content Libraries` (reference)
101+
102+
:ref:`Create a New Library` (how-to)
103+
104+
:ref:`Create and edit content in a Library` (how-to)
105+
106+
:ref:`Create and edit units in a Library` (how-to)
107+
108+
:ref:`Create and Edit New Subsections and Sections` (how-to)
109+
110+
:ref:`Add Library content to a course` (how-to)
111+
112+
:ref:`Add users to Libraries` (how-to)
113+
114+
115+
**Maintenance chart**
116+
117+
+--------------+-------------------------------+----------------+--------------------------------+
118+
| Review Date | Working Group Reviewer | Release |Test situation |
119+
+--------------+-------------------------------+----------------+--------------------------------+
120+
| 2026-04-08 | sarina | Verawood | Pass |
121+
+--------------+-------------------------------+----------------+--------------------------------+

source/educators/concepts/instructional_design/libraries.rst

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,6 @@ The libraries that you create or have access to are listed on the **Libraries**
4040
tab on the Studio Home page.
4141

4242
.. seealso::
43-
4443

4544
:ref:`Content Libraries Redesign Teak`
4645

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

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -42,8 +42,7 @@ original version in the legacy library. For details, refer to :ref:`Edit Compone
4242
a Legacy Library` and :ref:`Get the Latest Version of Library Content <Get the Latest Version of Legacy Library Content>`.
4343

4444

45-
.. seealso::
46-
45+
.. seealso::
4746

4847
:ref:`Content Libraries Redesign Teak`
4948

0 commit comments

Comments
 (0)