Libraries concept doc and override docs by sarina · Pull Request #1425 · openedx/docs.openedx.org

sarina · 2026-04-09T01:04:40Z

New documentation:

AI Disclaimer

I used Claude liberally in writing these docs, with only light edits as I'm not very familiar with the overrides feature. However I thought the Concept doc was pretty great as generated. Claude chat log

Notes to Reviewers

Please provide any necessary screenshots and I will incorporate them.

Please respond to document questions about Claude's assumptions.

google drive folder

Resolves #1297 #1298 #1299 Co-authored-by: Claude <noreply@anthropic.com>

Co-authored-by: Claude <noreply@anthropic.com>

sarina · 2026-04-09T01:08:53Z

+.. _Override Text Content in a Library-Referenced Component:
+
+Override Text Content in a Library-Referenced Component
+#######################################################


Gaps to verify before publishing:

The actual UI button labels — I used :guilabel:Edit and :guilabel:Save based on the spec description, but you'll want to confirm the exact labels in the Ulmo UI.

Whether the prerequisite about "published" library content is correct — the issue spec says the component needs to be published in the library first.

Numbering my responses based on the order your bullet points appear:

It's a pencil icon. And save is correct.

I tested this and it's true.

I put some screenshots in this google drive folder.

sarina · 2026-04-09T01:09:39Z

+.. _Override the Title of Library-Sourced Content:
+
+Override the Title of Library-Sourced Content
+#############################################


Decisions made: I split the steps by content type because the UI entry point is different — the course outline for structural content vs. the unit view for components. The spec doesn't describe the exact UI mechanics (pencil icon, click-to-edit, etc.), so those are reasonable assumptions based on how Studio typically works and should be verified against the actual Verawood UI.

Gaps to verify:

The exact UI interaction for renaming (pencil icon vs. double-click vs. a settings panel) — the spec doesn't specify, only that titles should be "editable."

Whether the rename UI differs between the course outline and unit views in any meaningful way that would require additional steps.

@sarina - This looks good, but there are more steps for the Rename a Component section for text components specifically . Below, I've outlined the steps for text components:

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.

Select the pencil icon next to the component's title in the modal.

Select the checkmark icon to save the new title.

Select the save button at the bottom of the modal to save the change.

Linking a google drive folder with screenshots for Renaming a Unit on the Course Outline page, Renaming a Video Component, and Renaming a Text Component. Please let me know if any questions come up!

Need access to this google folder

@crathbun428 this is just one image UnitPageText-3-TypeEdits.png - could you link the folder please?

I also don't think this image you linked is any of the things you've described (Renaming a Unit on the Course Outline page, Renaming a Video Component, and Renaming a Text Component).

crathbun428 · 2026-04-29T15:32:15Z

@sarina - Ah yes, this fell off my radar. Happy to review it - I can try to review by the end of the week.

sarina · 2026-05-08T14:24:41Z

+
+.. tags:: educator, how-to
+
+When you add a section, subsection, or unit from a content library to your


Suggested change

When you add a section, subsection, or unit from a content library to your

When you add a structural block (section, subsection, or unit) from a content library to your

crathbun428

Added the image names/locations for Override the Title of Library-Sourced Content screenshots. Rest looked good to me. Please let me know if you have any questions. Thanks!

crathbun428 · 2026-05-08T14:45:57Z

+#. Locate the library-sourced section, subsection, or unit you want to rename.
+
+#. Select the pencil icon or select the existing title to make it editable.
+


Insert image: CourseOutline-1-PencilIcon.png

crathbun428 · 2026-05-08T14:46:21Z

+#. Select the pencil icon or select the existing title to make it editable.
+
+#. Enter the new title.
+


Insert image: CourseOutline-2-TypeNewName.png

crathbun428 · 2026-05-08T14:46:56Z

+#. Enter the new title.
+
+#. Press :guilabel:`Enter` or select outside the field to save the change.
+


Insert image: CourseOutline-3-RenameSaved.png

crathbun428 · 2026-05-08T14:47:38Z

+   want to rename.
+
+#. Select the pencil icon next to the component's title to make it editable.
+


Insert image: UnitPageVideo-1-PencilIcon.png

crathbun428 · 2026-05-08T14:48:07Z

+#. Select the pencil icon next to the component's title to make it editable.
+
+#. Enter the new title.
+


Insert image: UnitPageVideo-2-TypeEdits.png

crathbun428 · 2026-05-08T14:48:36Z

+#. Enter the new title.
+
+#. Press :guilabel:`Enter` or select outside the field to save the change.
+


Insert image: UnitPageVideo-3-EditsComplete.png

crathbun428 · 2026-05-08T14:49:14Z

+#. 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.
+


Insert image: UnitPageText-1-PencilIcon.png

crathbun428 · 2026-05-08T14:49:39Z

+#. Select the pencil icon next to the text component's title to make it editable.
+
+#. Select the pencil icon next to the component's title in the modal.
+


Insert image: UnitPageText-2-ModalPencilIcon.png

crathbun428 · 2026-05-08T14:50:20Z

+#. Select the pencil icon next to the component's title in the modal.
+
+#. Select the checkmark icon to save the new title.
+


Insert image: UnitPageText-4-SaveEdit1.png

crathbun428 · 2026-05-08T14:50:40Z

+#. Select the checkmark icon to save the new title.
+
+#. Select the save button at the bottom of the modal to save the change.
+


Insert image: UnitPageText-5-SaveEdit2.png

sarina and others added 2 commits April 8, 2026 21:03

Docs on Content Library overrides (Verawood)

85c80c2

Resolves #1297 #1298 #1299 Co-authored-by: Claude <noreply@anthropic.com>

Concept Doc on Content Libraries

1753d89

Co-authored-by: Claude <noreply@anthropic.com>

This was linked to issues Apr 9, 2026

Documentation Required: Title overrides #1297

Open

Documentation Required: LIBRARIES Text component overrides - standalone text #1298

Open

Documentation Required: Text component overrides within structural blocks #1299

Open

sarina commented Apr 9, 2026

View reviewed changes

sarina requested review from crathbun428, edschema and sdaitzman April 9, 2026 01:20

This was referenced Apr 9, 2026

Documentation Required: Title overrides #1297

Open

Documentation Required: LIBRARIES Text component overrides - standalone text #1298

Open

Documentation Required: Text component overrides within structural blocks #1299

Open

fixup: overrides docs

efa70e7

sarina commented May 8, 2026

View reviewed changes

crathbun428 reviewed May 8, 2026

View reviewed changes


		.. tags:: educator, how-to

		When you add a section, subsection, or unit from a content library to your

	When you add a section, subsection, or unit from a content library to your
	When you add a structural block (section, subsection, or unit) from a content library to your

		#. Locate the library-sourced section, subsection, or unit you want to rename.

		#. Select the pencil icon or select the existing title to make it editable.

		#. Select the pencil icon or select the existing title to make it editable.

		#. Enter the new title.

		#. Enter the new title.

		#. Press :guilabel:`Enter` or select outside the field to save the change.

		want to rename.

		#. Select the pencil icon next to the component's title to make it editable.

		#. 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.

		#. Select the pencil icon next to the component's title in the modal.

		#. Select the checkmark icon to save the new title.

		#. Select the checkmark icon to save the new title.

		#. Select the save button at the bottom of the modal to save the change.

Conversation

sarina commented Apr 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

AI Disclaimer

Notes to Reviewers

Uh oh!

sarina Apr 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Rename a Text Component

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

crathbun428 commented Apr 29, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

crathbun428 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

sarina commented Apr 9, 2026 •

edited

Loading

sarina Apr 9, 2026 •

edited

Loading